POST/api/astro/numerology/tarot/1 credit

Tarot numerology

The birth card, its partner card, and the name card, across the 22 major arcana. The birth card is the Angeles Arrien reduction: month plus day plus the FULL YEAR, digit-summed until it lands in 0-21. The partner card is the single-digit reduction of that, which is what pairs a high trump with a low one. The name card is the Pythagorean name total reduced the same way. Send `name`, `date_time`, or both. A field you omit simply does not appear in the response.

https://api.occultapi.com/api/astro/numerology/tarot/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

Field	Type	Required	Notes
date_time	string (date-time)	optional	The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers.
name	string	optional

Example request

This example is not yet verified

The field names and types below are taken from the API definition and are accurate, but this particular body has not returned a success when we last ran it — it may need a value we cannot infer. Treat it as a starting point rather than a working command.

curl -X POST https://api.occultapi.com/api/astro/numerology/tarot/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-09-01 06:00:00"}'

Response

A verified example response is not available for this endpoint yet. The request shape above is generated from the API definition and is accurate; we publish response samples only once we have proven them against a live call.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.