{"openapi":"3.1.0","info":{"title":"Tarot API","version":"1.0.0","description":"The complete 78-card tarot deck as an API — 22 Major Arcana and 56 Minor Arcana across the four suits (Wands, Cups, Swords and Pentacles). Look up any card by id or name (e.g. The Fool, The Lovers, Ace of Cups) for its upright and reversed meanings and the classic Rider-Waite description, search the whole deck by keyword or theme (e.g. love), browse a single minor suit, or draw a spread of random cards for an instant reading. Each card carries its arcana type, suit, numeric value and both interpretations. Ideal for tarot and astrology apps, daily-card widgets, divination and journaling tools, games and content sites.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tarot-api","description":"oanor gateway"}],"tags":[{"name":"Tarot"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/card":{"get":{"operationId":"get_v1_card","tags":["Tarot"],"summary":"A card by id or name","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Card id, e.g. ar00 (The Fool) or wands01","schema":{"type":"string"},"example":"ar00"},{"name":"name","in":"query","required":false,"description":"Card name, e.g. The Lovers","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"card":{"id":"ar00","name":"The Fool","type":"major-arcana","value":"ZERO","value_int":0,"description":"With light step, as if earth and its trammels had little power to restrain him, a young man in gorgeous vestments pauses at the brink of a precipice among the great heights of the world; he surveys the blue distance before him-its expanse of sky rather than the prospect below. His act of eager walking is still indicated, though he is stationary at the given moment; his dog is still bounding. The edge which opens on the depth has no terror; it is as if angels were waiting to uphold him, if it came about that he leaped from the height. His countenance is full of intelligence and expectant dream. He has a rose in one hand and in the other a costly wand, from which depends over his right shoulder a wallet curiously embroidered. He is a prince of the other world on his travels through this one-all amidst the morning glory, in the keen air. The sun, which shines behind him, knows whence he came, whither he is going, and how he will return by another path after many days. He is the spirit in search of experience. Many symbols of the Instituted Mysteries are summarized in this card, which reverses, under high warrants, all the confusions that have preceded it. In his Manual of Cartomancy, Grand Orient has a curious suggestion of the office of Mystic Fool, as apart of his process in higher divination; but it might call for more than ordinary gifts to put it into operation. We shall see how the card fares according to the common arts of fortune-telling, and it will be an example, to those who can discern, of the fact, otherwise so evident, that the Trumps Major had no place originally in the arts of psychic gambling, when cards are used as the counters and pretexts. Of the circumstances under which this art arose we know, however, very little. The conventional explanations say that the Fool signifies the flesh, the sensitive life, and by a peculiar satire its subsidiary name was at one time the alchemist, as depicting folly at the most insensate stage.","meaning_upright":"Folly, mania, extravagance, intoxication, delirium, frenzy, bewrayment.","meaning_reversed":"Negligence, absence, distribution, carelessness, apathy, nullity, vanity."}},"meta":{"timestamp":"2026-06-01T00:04:27.224Z","request_id":"cada60fc-7716-4c5d-bf88-337f8cbc880d"},"status":"ok","message":"Card retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cards":{"get":{"operationId":"get_v1_cards","tags":["Tarot"],"summary":"The whole deck, or one minor suit","description":"","parameters":[{"name":"suit","in":"query","required":false,"description":"wands | cups | swords | pentacles (omit for all 78)","schema":{"type":"string"},"example":"cups"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"suit":"cups","cards":[{"id":"cupa","name":"Page of Cups","suit":"cups","type":"minor-arcana","value":"page","value_int":11,"description":"A fair, pleasing, somewhat effeminate page, of studious and intent aspect, contemplates a fish rising from a cup to look at him. It is the pictures of the mind taking form.","meaning_upright":"Fair young man, one impelled to render service and with whom the Querent will be connected; a studious youth; news, message; application, reflection, meditation; also these things directed to business.","meaning_reversed":"Taste, inclination, attachment, seduction, deception, artifice."},{"id":"cukn","name":"Knight of Cups","suit":"cups","type":"minor-arcana","value":"knight","value_int":12,"description":"Graceful, but not warlike; riding quietly, wearing a winged helmet, referring to those higher graces of the imagination which sometimes characterize this card. He too is a dreamer, but the images of the side of sense haunt him in his vision.","meaning_upright":"Arrival, approach--sometimes that of a messenger; advances, proposition, demeanour, invitation, incitement.","meaning_reversed":"Trickery, artifice, subtlety, swindling, duplicity, fraud."},{"id":"cuqu","name":"Queen of Cups","suit":"cups","type":"minor-arcana","value":"queen","value_int":13,"description":"Beautiful, fair, dreamy--as one who sees visions in a cup. This is, however, only one of her aspects; she sees, but she also acts, and her activity feeds her dream.","meaning_upright":"Good, fair woman; honest, devoted woman, who will do service to the Querent; loving intelligence, and hence the gift of vision; success, happiness, pleasure; also wisdom, virtue; a perfect spouse and a good mother.","meaning_reversed":"The accounts vary; good woman; otherwise, distinguished woman but one not to be trusted; perverse woman; vice, dishonour, depravity."},{"id":"cuki","name":"King of Cups","suit":"cups","type":"minor-arcana","value":"king","value_int":14,"description":"He holds a short sceptre in his left hand and a great cup in his right; his throne is set upon the sea; on one side a ship is riding and on the other a dolphin is leaping. The implicit is that the Sign of the Cup naturally refers to water, which appears in all the court cards.","meaning_upright":"Fair man, man of business, law, or divinity; responsible, disposed to oblige the Querent; also equity, art and science, including those who profess science, law and art; creative intelligence.","meaning_reversed":"Dishonest, double-dealing man; roguery, exaction, injustice, vice, scandal, pillage, considerable loss."},{"id":"cuac","name":"Ace of Cups","suit":"cups","type":"minor-arcana","value":"ace","value_int":1,"description":"The waters are beneath, and thereon are water-lilies; the hand issues from the cloud, holding in its palm the cup, from which four streams are pouring; a dove, bearing in its bill a cross-marked Host, descends to place the Wafer in the Cup; the dew of water is falling on all sides. It is an intimation of that which may lie behind the Lesser Arcana.","meaning_upright":"House of the true heart, joy, content, abode, nourishment, abundance, fertility; Holy Table, felicity hereof.","meaning_reversed":"House of the false heart, mutation, instability, revolution."},{"id":"cu02","name":"Two of Cups","suit":"cups","type":"minor-arcana","value":"two","value_int":2,"description":"A youth and maiden are pledging one another, and above their cups rises the Caduceus of Hermes, between the great wings of which there appears a lion's head. It is a variant of a sign which is found in a few old examples of this card. Some curious emblematical meanings are attached to it, but they do not concern us in this place.","meaning_upright":"Love, passion, friendship, affinity, union, concord, sympathy, the interrelation of the sexes, and--as a suggestion apart from all offices of divination--that desire which is not in Nature, but by which Nature is sanctified.","meaning_reversed":"Lust, cupidity, jealousy, wish, desire, but the card may also give, says W., \"that desire which is not in nature, but by which nature is sanctified.\""},{"id":"cu03","name":"Three of Cups","suit":"cups","type":"minor-arcana","value":"three","value_int":3,"description":"Maidens in a garden-ground with cups uplifted, as if pledging one another.","meaning_upright":"The conclusion of any matter in plenty, perfection and merriment; happy issue, victory, fulfilment, solace, healing,","meaning_reversed":"Expedition, dispatch, achievement, end. It signifies also the side of excess in physical enjoyment, and the pleasures of the senses."},{"id":"cu04","name":"Four of Cups","suit":"cups","type":"minor-arcana","value":"four","value_int":4,"description":"A young man is seated under a tree and contemplates three cups set on the grass before him; an arm issuing from a cloud offers him another cup. His expression notwithstanding is one of discontent with his environment.","meaning_upright":"Weariness, disgust, aversion, imaginary vexations, as if the wine of this world had caused satiety only; another wine, as if a fairy gift, is now offered the wastrel, but he sees no consolation therein. This is also a card of blended pleasure.","meaning_reversed":"Novelty, presage, new instruction, new relations."},{"id":"cu05","name":"Five of Cups","suit":"cups","type":"minor-arcana","value":"five","value_int":5,"description":"A dark, cloaked figure, looking sideways at three prone cups two others stand upright behind him; a bridge is in the background, leading to a small keep or holding. Divanatory Meanings: It is a card of loss, but something remains over; three have been taken, but two are left; it is a card of inheritance, patrimony, transmission, but not corresponding to expectations; with some interpreters it is a card of marriage, but not without bitterness or frustration. Reversed: News, alliances, affinity, consanguinity, ancestry, return, false projects","meaning_upright":"A dark, cloaked figure, looking sideways at three prone cups two others stand upright behind him; a bridge is in the background, leading to a small keep or holding. Divanatory Meanings: It is a card of loss, but something remains over; three have been taken, but two are left; it is a card of inheritance, patrimony, transmission, but not corresponding to expectations; with some interpreters it is a card of marriage, but not without bitterness or frustration.","meaning_reversed":"News, alliances, affinity, consanguinity, ancestry, return, false projects."},{"id":"cu06","name":"Six of Cups","suit":"cups","type":"minor-arcana","value":"six","value_int":6,"description":"Children in an old garden, their cups filled with flowers.","meaning_upright":"A card of the past and of memories, looking back, as--for example--on childhood; happiness, enjoyment, but coming rather from the past; things that have vanished. Another reading reverses this, giving new relations, new knowledge, new environment, and then the children are disporting in an unfamiliar precinct.","meaning_reversed":"The future, renewal, that which will come to pass presently."},{"id":"cu07","name":"Seven of Cups","suit":"cups","type":"minor-arcana","value":"seven","value_int":7,"description":"Strange chalices of vision, but the images are more especially those of the fantastic spirit.","meaning_upright":"Fairy favours, images of reflection, sentiment, imagination, things seen in the glass of contemplation; some attainment in these degrees, but nothing permanent or substantial is suggested.","meaning_reversed":"Desire, will, determination, project."},{"id":"cu08","name":"Eight of Cups","suit":"cups","type":"minor-arcana","value":"eight","value_int":8,"description":"A man of dejected aspect is deserting the cups of his felicity, enterprise, undertaking or previous concern.","meaning_upright":"The card speaks for itself on the surface, but other readings are entirely antithetical--giving joy, mildness, timidity, honour, modesty. In practice, it is usually found that the card shews the decline of a matter, or that a matter which has been thought to be important is really of slight consequence--either for good or evil.","meaning_reversed":"Great joy, happiness, feasting."},{"id":"cu09","name":"Nine of Cups","suit":"cups","type":"minor-arcana","value":"nine","value_int":9,"description":"A goodly personage has feasted to his heart's content, and abundant refreshment of wine is on the arched counter behind him, seeming to indicate that the future is also assured. The picture offers the material side only, but there are other aspects.","meaning_upright":"Concord, contentment, physical bien-être; also victory, success, advantage; satisfaction for the Querent or person for whom the consultation is made.","meaning_reversed":"Truth, loyalty, liberty; but the readings vary and include mistakes, imperfections, etc."},{"id":"cu10","name":"Ten of Cups","suit":"cups","type":"minor-arcana","value":"ten","value_int":10,"description":"Appearance of Cups in a rainbow; it is contemplated in wonder and ecstacy by a man and woman below, evidently husband and wife. His right arm is about her; his left is raised upward; she raises her right arm. The two children dancing near them have not observed the prodigy but are happy after their own manner. There is a home-scene beyond.","meaning_upright":"Contentment, repose of the entire heart; the perfection of that state; also perfection of human love and friendship; if with several picture-cards, a person who is taking charge of the Querent's interests; also the town, village or country inhabited by the Querent.","meaning_reversed":"Repose of the false heart, indignation, violence."}],"count":14},"meta":{"timestamp":"2026-06-01T00:04:27.424Z","request_id":"bfec3060-a529-4e1f-9503-687dbeed5781"},"status":"ok","message":"Deck retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/draw":{"get":{"operationId":"get_v1_draw","tags":["Tarot"],"summary":"Draw random cards for a reading","description":"","parameters":[{"name":"n","in":"query","required":false,"description":"How many cards (1-10, default 3)","schema":{"type":"string"},"example":"3"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"cards":[{"id":"cu06","name":"Six of Cups","suit":"cups","type":"minor-arcana","value":"six","value_int":6,"description":"Children in an old garden, their cups filled with flowers.","meaning_upright":"A card of the past and of memories, looking back, as--for example--on childhood; happiness, enjoyment, but coming rather from the past; things that have vanished. Another reading reverses this, giving new relations, new knowledge, new environment, and then the children are disporting in an unfamiliar precinct.","meaning_reversed":"The future, renewal, that which will come to pass presently."},{"id":"pe03","name":"Three of Pentacles","suit":"pentacles","type":"minor-arcana","value":"three","value_int":3,"description":"A sculptor at his work in a monastery. Compare the design which illustrates the Eight of Pentacles. The apprentice or amateur therein has received his reward and is now at work in earnest.","meaning_upright":"Métier, trade, skilled labour; usually, however, regarded as a card of nobility, aristocracy, renown, glory.","meaning_reversed":"Mediocrity, in work and otherwise, puerility, pettiness, weakness."},{"id":"wa08","name":"Eight of Wands","suit":"wands","type":"minor-arcana","value":"eight","value_int":8,"description":"The card represents motion through the immovable-a flight of wands through an open country; but they draw to the term of their course. That which they signify is at hand; it may be even on the threshold.","meaning_upright":"Activity in undertakings, the path of such activity, swiftness, as that of an express messenger; great haste, great hope, speed towards an end which promises assured felicity; generally, that which is on the move; also the arrows of love.","meaning_reversed":"Arrows of jealousy, internal dispute, stingings of conscience, quarrels; and domestic disputes for persons who are married."}],"drawn":3},"meta":{"timestamp":"2026-06-01T00:04:27.614Z","request_id":"4f5f40d6-221f-4b97-9c7b-0a0dd70f7674"},"status":"ok","message":"Cards drawn","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Tarot"],"summary":"Search cards by name or meaning","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Keyword or theme, e.g. love","schema":{"type":"string"},"example":"love"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"cards":[{"id":"ar06","name":"The Lovers","type":"major-arcana","value":"6","value_int":6,"description":"The sun shines in the zenith, and beneath is a great winged figure with arms extended, pouring down influences. In the foreground are two human figures, male and female, unveiled before each other, as if Adam and Eve when they first occupied the paradise of the earthly body. Behind the man is the Tree of Life, bearing twelve fruits, and the Tree of the Knowledge of Good and Evil is behind the woman; the serpent is twining round it. The figures suggest youth, virginity, innocence and love before it is contaminated by gross material desire. This is in all simplicity the card of human love, here exhibited as part of the way, the truth and the life. It replaces, by recourse to first principles, the old card of marriage, which I have described previously, and the later follies which depicted man between vice and virtue. In a very high sense, the card is a mystery of the Covenant and Sabbath. The suggestion in respect of the woman is that she signifies that attraction towards the sensitive life which carries within it the idea of the Fall of Man, but she is rather the working of a Secret Law of Providence than a willing and conscious temptress. It is through her imputed lapse that man shall arise ultimately, and only by her can he complete himself. The card is therefore in its way another intimation concerning the great mystery of womanhood. The old meanings fall to pieces of necessity with the old pictures, but even as interpretations of the latter, some of them were of the order of commonplace and others were false in symbolism.","meaning_upright":"Attraction, love, beauty, trials overcome.","meaning_reversed":"Failure, foolish designs. Another account speaks of marriage frustrated and contrarieties of all kinds."},{"id":"wapa","name":"Page of Wands","suit":"wands","type":"minor-arcana","value":"page","value_int":11,"description":"In a scene similar to the former, a young man stands in the act of proclamation. He is unknown but faithful, and his tidings are strange.","meaning_upright":"Dark young man, faithful, a lover, an envoy, a postman. Beside a man, he will bear favourable testimony concerning him. A dangerous rival, if followed by the Page of Cups. Has the chief qualities of his suit. He may signify family intelligence.","meaning_reversed":"Anecdotes, announcements, evil news. Also indecision and the instability which accompanies it."},{"id":"waqu","name":"Queen of Wands","suit":"wands","type":"minor-arcana","value":"queen","value_int":13,"description":"The Wands throughout this suit are always in leaf, as it is a suit of life and animation. Emotionally and otherwise, the Queen's personality corresponds to that of the King, but is more magnetic.","meaning_upright":"A dark woman, countrywoman, friendly, chaste, loving, honourable. If the card beside her signifies a man, she is well disposed towards him; if a woman, she is interested in the Querent. Also, love of money, or a certain success in business.","meaning_reversed":"Good, economical, obliging, serviceable. Signifies also--but in certain positions and in the neighbourhood of other cards tending in such directions--opposition, jealousy, even deceit and infidelity."},{"id":"wa08","name":"Eight of Wands","suit":"wands","type":"minor-arcana","value":"eight","value_int":8,"description":"The card represents motion through the immovable-a flight of wands through an open country; but they draw to the term of their course. That which they signify is at hand; it may be even on the threshold.","meaning_upright":"Activity in undertakings, the path of such activity, swiftness, as that of an express messenger; great haste, great hope, speed towards an end which promises assured felicity; generally, that which is on the move; also the arrows of love.","meaning_reversed":"Arrows of jealousy, internal dispute, stingings of conscience, quarrels; and domestic disputes for persons who are married."},{"id":"cu02","name":"Two of Cups","suit":"cups","type":"minor-arcana","value":"two","value_int":2,"description":"A youth and maiden are pledging one another, and above their cups rises the Caduceus of Hermes, between the great wings of which there appears a lion's head. It is a variant of a sign which is found in a few old examples of this card. Some curious emblematical meanings are attached to it, but they do not concern us in this place.","meaning_upright":"Love, passion, friendship, affinity, union, concord, sympathy, the interrelation of the sexes, and--as a suggestion apart from all offices of divination--that desire which is not in Nature, but by which Nature is sanctified.","meaning_reversed":"Lust, cupidity, jealousy, wish, desire, but the card may also give, says W., \"that desire which is not in nature, but by which nature is sanctified.\""},{"id":"cu10","name":"Ten of Cups","suit":"cups","type":"minor-arcana","value":"ten","value_int":10,"description":"Appearance of Cups in a rainbow; it is contemplated in wonder and ecstacy by a man and woman below, evidently husband and wife. His right arm is about her; his left is raised upward; she raises her right arm. The two children dancing near them have not observed the prodigy but are happy after their own manner. There is a home-scene beyond.","meaning_upright":"Contentment, repose of the entire heart; the perfection of that state; also perfection of human love and friendship; if with several picture-cards, a person who is taking charge of the Querent's interests; also the town, village or country inhabited by the Querent.","meaning_reversed":"Repose of the false heart, indignation, violence."},{"id":"pe05","name":"Five of Pentacles","suit":"pentacles","type":"minor-arcana","value":"five","value_int":5,"description":"Two mendicants in a snow-storm pass a lighted casement.","meaning_upright":"The card foretells material trouble above all, whether in the form illustrated--that is, destitution--or otherwise. For some cartomancists, it is a card of love and lovers-wife, husband, friend, mistress; also concordance, affinities. These alternatives cannot be harmonized.","meaning_reversed":"Disorder, chaos, ruin, discord, profligacy."},{"id":"swac","name":"Ace of Swords","suit":"swords","type":"minor-arcana","value":"ace","value_int":1,"description":"A hand issues from a cloud, grasping as word, the point of which is encircled by a crown.","meaning_upright":"Triumph, the excessive degree in everything, conquest, triumph of force. It is a card of great force, in love as well as in hatred. The crown may carry a much higher significance than comes usually within the sphere of fortune-telling.","meaning_reversed":"The same, but the results are disastrous; another account says--conception, childbirth, augmentation, multiplicity."},{"id":"sw06","name":"Six of Swords","suit":"swords","type":"minor-arcana","value":"six","value_int":6,"description":"A ferryman carrying passengers in his punt to the further shore. The course is smooth, and seeing that the freight is light, it may be noted that the work is not beyond his strength.","meaning_upright":"Journey by water, route, way, envoy, commissionary, expedient.","meaning_reversed":"Declaration, confession, publicity; one account says that it is a proposal of love."}],"count":9,"query":"love"},"meta":{"timestamp":"2026-06-01T00:04:27.803Z","request_id":"81c1f45e-eb9a-469f-9c05-c9ae1cf2aba0"},"status":"ok","message":"Cards searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Suits & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The 78-card tarot deck (22 Major Arcana + 56 Minor Arcana). /v1/card = a card by id (e.g. ar00 → The Fool) or name, with upright & reversed meanings; /v1/draw = draw n random cards (1-10) for a reading; /v1/search = search cards by name or meaning (e.g. q=love); /v1/cards = the whole deck or one minor suit (suit=wands|cups|swords|pentacles).","suits":["wands","cups","swords","pentacles"],"source":"tarotapi.dev","deck_size":78,"endpoints":["/v1/card","/v1/draw","/v1/search","/v1/cards","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:27.872Z","request_id":"e802e1af-1683-48d9-86a9-da5ca8a7ed8f"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":11500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":270,"monthly_call_quota":165000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":900,"monthly_call_quota":710000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2870,"monthly_call_quota":2920000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tarot-api"}