Map natal planets to their corresponding Tarot Major Arcana.
Example request
cURL
curl -X POST https://api.grahaapi.com/v1/tarot/astro-tarot \
-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 input. The response is JSON: {"success": true, "data": {…}, "meta": {…}} with Hindi name twins where available (e.g. sign / sign_hi).
Request fields
| Field | Type | Required | Description |
|---|---|---|---|
question | string | null | optional | Your question for the cards |
spread | string | optional | Spread type: three_card, celtic_cross, single, yes_no, past_present_future |
deck | string | optional | Tarot deck: rider_waite, thoth, osho_zen, marseille |
birth_chart | BirthRequest | null | optional | Optional birth details for personalised reading |
seed | integer | null | optional | Integer seed for reproducible draws (optional) |
Example body
JSON
{
"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"
}