By topic / Tarot API
Tarot API: draws and spreads
Draw from a full deck with a seed you can repeat, and use a fixed spread for a question. Each card comes with its orientation, keywords, meaning and an interpretation for its position.
What people build with it
- A daily card
- Yes or no answers
- Readings in a lifestyle app
The endpoints
- Tarot: Daily Card
Draws cards for the Daily Card spread and returns them with a reading.
POST /v1/tarot/tarot-daily
1 credit
- Tarot: Yes / No
Draws cards for the Yes / No spread and returns them with a reading.
POST /v1/tarot/tarot-yes-no
1 credit
- Tarot: Past, Present, Future
Draws cards for the Past, Present, Future spread and returns them with a reading.
POST /v1/tarot/tarot-past-present-future
1 credit
- Tarot: Celtic Cross
Draws cards for the Celtic Cross spread and returns them with a reading.
POST /v1/tarot/tarot-celtic-cross
1 credit
- Tarot: Year Ahead
Draws cards for the Year Ahead spread and returns them with a reading.
POST /v1/tarot/tarot-year-ahead
1 credit
- Tarot: Compatibility
Draws cards for the Compatibility spread and returns them with a reading.
POST /v1/tarot/tarot-compatibility
1 credit
Common questions
- Is the draw random?
- Yes, unless you send a seed, which makes the same draw repeatable.

