Tarot Card Draw API
AvailableTurns over the top N cards (1-78) of a shuffled deck with orientation, keywords and element; a draw can be replayed by its draw_id, or fixed for the day.
Call it with POST /v1/tarot/tarot-shuffle. Input: no input. Output: JSON, as a direct response. Each successful call costs 1 credit.
- Endpoint
- POST /v1/tarot/tarot-shuffle
- Input
- No input
- Output
- JSON
- Delivery
- Direct response
- Cost
- 1 credit
- Compute class
- Light
Example response
Fields in data (inferred from the example)
reading_type· stringdraw_id· stringdaily· booleanreplayable· booleanday· nulldescription· stringcards· array of objectdominant_element· stringmajor_arcana_count· integertotal_cards_shown· integer
Example response
Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and images are replaced by a placeholder.
Loading the example…
Request schema and every field: the Tarot reference.
Tarot Card Draw API: common questions
What does the Tarot Card Draw API return?
Turns over the top N cards (1-78) of a shuffled deck with orientation, keywords and element; a draw can be replayed by its draw_id, or fixed for the day. The response's data object includes reading_type, draw_id, daily, replayable, day, description, cards and dominant_element. See the reference for an example response.
What input does Tarot Card Draw need?
No input.
How much does a Tarot Card Draw call cost?
1 credit per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.
Can I try it before paying?
Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.