POST/api/astro/tarot/draw/1 credit

Tarot draw

Draw cards from a shuffled seventy-eight card Rider-Waite-Smith deck. Cards are drawn without replacement, so a draw never repeats one. Each comes back with its arcana, suit, rank, number, orientation and the standard keywords for the way it landed. Every response carries the `seed` that produced it, and sending that seed back reproduces the draw exactly — same cards, same order, same way up. Omit it and one is generated and returned, so a fresh draw is the default and repeating it afterwards is always possible. This is what lets a client store a reading and show it again rather than handing the querent a different answer to the same question. `allow_reversed` and `reversal_chance` are there because readers differ: some work upright-only, some reverse about half the deck, some far less.

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

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
allow_reversed	boolean	optional	Whether cards can come up reversed. Some readers work upright-only.
count	integer	optional	How many cards to draw, at most 21. Cards are drawn without replacement, so none can repeat. min 1 · max 21
question	string	optional	Optional. Echoed back, and folded into a generated seed.
reversal_chance	number (double)	optional	Probability of a reversal, when reversals are allowed. min 0 · max 1
seed	string	optional	Send a seed to reproduce a draw exactly. Omit it and one is generated and returned, so any draw can be repeated afterwards.

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/tarot/draw/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"What should I focus on this month?","count":3,"seed":"sample-draw"}'

Response

{
  "data": {
    "question": "What should I focus on this month?",
    "seed": "sample-draw",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 50,
        "name": "Ace of Swords",
        "arcana": "minor",
        "suit": "Swords",
        "rank": "Ace",
        "number": 1,
        "element": "air",
        "upright": "clarity, breakthrough, truth cutting through",
        "reversed": "confusion, a truth misused",
        "orientation": "reversed",
        "meaning": "confusion, a truth misused",
        "yes_no": "no"
      },
      {
        "position": 2,
        "id": 32,
        "name": "Page of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Page",
        "number": 11,
        "element": "fire",
        "upright": "curiosity, an idea, enthusiasm",
        "reversed": "unfocused energy, an idea unformed",
        "orientation": "reversed",
        "meaning": "unfocused energy, an idea unformed",
        "yes_no": "no"
      },
      {
        "position": 3,
        "id": 31,
        "name": "Ten of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Ten",
        "number": 10,
        "element": "fire",
        "upright": "burden, overload, carrying too much",
        "reversed": "putting a load down, delegation",
        "orientation": "upright",
        "meaning": "burden, overload, carrying too much",
        "yes_no": "no"
      }
    ],
    "count": 3
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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.