Skip to content
POST/api/astro/numerology/cheiro/1 credit

Cheiro numerology

The Chaldean letter table read to a compound number, alongside the single digit and its planetary ruler. Cheiro did not invent a letter table - his IS the Chaldean one, the same table /api/astro/numerology/chaldean/ uses. What is his is the reading of the compound number and the planetary rulership of each digit. WORTH KNOWING: Cheiro's compound meanings are defined for 10-52 only. A compound past 52 is folded back by digit-summing, but a short name never reaches 10 in the first place and a long one can fold below it. In those cases `compound_meaning` is null and `compound_note` says why - read `single_number` and `ruling_planet` instead. We would rather return null than invent a meaning the tradition does not have.

https://api.occultapi.com/api/astro/numerology/cheiro/
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

FieldTypeRequiredNotes
date_timestring (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.

namestringoptional

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/cheiro/ \
  -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.