POST/api/astro/tarot/deck/1 credit

Tarot deck reference

The whole deck, and every spread, as reference data. All seventy-eight cards — twenty-two major arcana and four suits of fourteen — each with its suit, element, number and the keywords for both orientations. Also every spread with its position labels, which is the only way to discover what `spread` accepts. Exists so a client can render a card it has drawn without keeping its own copy of the deck and letting the two drift apart.

https://yogataraapi.prahlad.app/api/astro/tarot/deck/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

Field	Type	Required	Notes
arcana	string	optional	Narrow the listing. The twenty-two major arcana are often wanted on their own — some readers work with them alone. `bothmajorminor`
suit	string	optional	Return only one suit. Ignored when arcana is 'major'. `allWandsCupsSwordsPentacles`

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/tarot/deck/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arcana":"both","suit":"all"}'

Response

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"deck\": \"Rider-Waite-Smith\", \"arcana\": \"both\", \"suit\": \"all\", \"count\": 78, \"deck_size\": 78, \"suits\": [{\"suit\": \"Wands\", \"element\": \"fire\", \"covers\": \"action, ambition, creativity, drive\"}, {\"suit\": \"Cups\", \"element\": \"water\", \"covers\": \"emotion, relationship, intuition, the inner life\"}, {\"suit\": \"Swords\", \"element\": \"air\", \"covers\": \"thought, conflict, truth, communication\"}, {\"suit\": \"Pentacles\", \"element\": \"earth\", \"covers\": \"work, money, the body, the material world\"}], \"ranks\": [\"Ace\", \"Two\", \"Three\", \"Four\", \"Five\", \"Six\", \"Seven\", \"Eight\", \"Nine\", \"Ten\", \"Page\", \"Knight\", \"Queen\", \"King\"], \"cards\": [{\"id\": 0, \"name\": \"The Fool\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 0, \"element\": null, \"upright\": \"beginnings, innocence, spontaneity, a leap taken\", \"reversed\": \"naivety, recklessness, a risk not thought through\"}, {\"id\": 1, \"name\": \"The Magician\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 1, \"element\": null, \"upright\": \"manifestation, resourcefulness, power, focused will\", \"reversed\": \"manipulation, untapped talent, scattered effort\"}, {\"id\": 2, \"name\": \"The High Priestess\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 2, \"element\": null, \"upright\": \"intuition, mystery, the inner voice, patience\", \"reversed\": \"secrets withheld, disconnection from instinct\"}, {\"id\": 3, \"name\": \"The Empress\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 3, \"element\": null, \"upright\": \"abundance, nurturing, fertility, creation\", \"reversed\": \"dependence, smothering, creative block\"}, {\"id\": 4, \"name\": \"The Emperor\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 4, \"element\": null, \"upright\": \"authority, structure, control, established order\", \"reversed\": \"domination, rigidity, authority misused\"}, {\"id\": 5, \"name\": \"The Hierophant\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 5, \"element\": null, \"upright\": \"tradition, institutions, guidance, orthodoxy\", \"reversed\": \"rebellion, dogma questioned, going your own way\"}, {\"id\": 6, \"name\": \"The Lovers\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 6, \"element\": null, \"upright\": \"union, choice, alignment of values\", \"reversed\": \"disharmony, misalignment, a choice avoided\"}, {\"id\": 7, \"name\": \"The Chariot\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 7, \"element\": null, \"upright\": \"determination, momentum, willpower, control held\", \"reversed\": \"lack of direction, aggression, momentum lost\"}, {\"id\": 8, \"name\": \"Strength\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 8, \"element\": null, \"upright\": \"courage, patience, gentle power, self-mastery\", \"reversed\": \"self-doubt, force misapplied, inner weakness\"}, {\"id\": 9, \"name\": \"The Hermit\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 9, \"element\": null, \"upright\": \"introspection, solitude, the search, inner guidance\", \"reversed\": \"isolation, withdrawal, refusing counsel\"}, {\"id\": 10, \"name\": \"Wheel of Fortune\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 10, \"element\": null, \"upright\": \"luck, cycles, a turning point, fate moving\", \"reversed\": \"bad luck, resistance to change, a cycle repeating\"}, {\"id\": 11, \"name\": \"Justice\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 11, \"element\": null, \"upright\": \"fairness, truth, cause and effect, accountability\", \"reversed\": \"unfairness, dishonesty, consequences dodged\"}, {\"id\": 12, \"name\": \"The Hanged Man\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 12, \"element\": null, \"upright\": \"pause, surrender, a new perspective, suspension\", \"reversed\": \"stalling, indecision, delay without purpose\"}, {\"id\": 13, \"name\": \"Death\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 13, \"element\": null, \"upright\": \"endings, transformation, transition, what must go\", \"reversed\": \"resistance to change, stagnation, holding on\"}, {\"id\": 14, \"name\": \"Temperance\", \"arcana\": \"major\", \"suit\": null, \"rank\": null, \"number\": 14, \"element\": null, \"upright\": \"b"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.