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"}'
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.
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.