curl -X POST https://yogataraapi.prahlad.app/api/astro/tarot/spread/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"How is this relationship placed?","spread":"three_card","seed":"sample-spread"}'
A named spread with every position labelled.
Six layouts, from a single card to the ten-card Celtic Cross — also past/present/future, situation/action/outcome, a five-card relationship spread and the seven-card horseshoe.
The labels are the point. Three unlabelled cards are three cards; "Past, Present, Future" is a reading. Each card comes back with the position it fell in and what that position stands for.
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.
Request fields
Field
Type
Required
Notes
allow_reversed
boolean
optional
Whether cards can come up reversed. Some readers work upright-only.
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.