Home › API Docs › Tarot API › Interpretation

Interpretation

POST /v1/tarot/interpretation

Detailed interpretation of a specific card by name or ID.

Example request

curl -X POST https://api.grahaapi.com/v1/tarot/interpretation   -H "Authorization: Bearer sk-test-your-key"   -H "Content-Type: application/json"   -d '{"birth_chart":{"dob":"1990-06-15","lat":28.6139,"lon":77.209,"tob":"10:30","tz":5.5},"deck":"rider_waite","question":"What does my future hold?","spread":"three_card"}'

Test keys (sk-test-…) are free and unlimited, and return the exact production response structure computed from a fixed sample chart. The response is JSON: {"success": true, "data": {…}, "meta": {…}} with Hindi + English strings, computed on the Lahiri ayanamsa.

Request fields

Field	Type	Required	Description
`question`	`string \| null`	—	Your question for the cards
`spread`	`string`	—	Spread type: three_card, celtic_cross, single, yes_no, past_present_future
`deck`	`string`	—	Tarot deck: rider_waite, thoth, osho_zen, marseille
`birth_chart`	`BirthRequest \| null`	—	Optional birth details for personalised reading
`seed`	`integer \| null`	—	Integer seed for reproducible draws (optional)

Example body

{
  "birth_chart": {
    "dob": "1990-06-15",
    "lat": 28.6139,
    "lon": 77.209,
    "tob": "10:30",
    "tz": 5.5
  },
  "deck": "rider_waite",
  "question": "What does my future hold?",
  "spread": "three_card"
}

Get a free API key Try it in the playground

Related Tarot endpoints

/v1/tarot/astro-tarot · /v1/tarot/card/{card_id} · /v1/tarot/cards · /v1/tarot/celtic-cross · /v1/tarot/daily · /v1/tarot/deck/{deck_name}/cards