# Kabbalah

Three endpoints, and the difference between them matters: two compute, the third is a reference table. Every response says which it is.

| Endpoint | Credits | What it is |
|---|---|---|
| `POST /v1/kabbalah/gematria` | 10 | Seven standard ciphers over a Hebrew text |
| `GET /v1/kabbalah/shem-names` | 5 | 72 names, computed from Exodus 14:19-21 |
| `GET /v1/kabbalah/sephiroth` | 5 | The ten sephirot, a reference table |

## Gematria

Seven ciphers, each checkable by hand: `hechrachi` (absolute), `gadol` (large), `katan` (small), `siduri` (ordinal), `kolel` (plus the letter count), `atbash` and `albam` (substitutions).

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/kabbalah/gematria \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{ "text": "שלום" }'
    ```
  </TabItem>
</Tabs>

**Final letter forms are the one real fork, and it is a matter of convention rather than doctrine.** In the absolute value a final letter counts as its ordinary form; in the large value it carries 500 to 900. The response therefore gives both instead of choosing for you: שלום is 376 and 936, a difference of 560.

Vowel points and cantillation are stripped before counting, and anything that is not a Hebrew letter is ignored. A transliteration comes back 400 rather than zero, because a zero would read as a result.

## The seventy-two names

Exodus 14:19, 14:20 and 14:21 hold exactly seventy-two consonants each. Written one above the other with the middle verse reversed, they yield 72 three-letter names read down the columns. The method is described by Rashi and in Sefer HaBahir.

**We ship three verses rather than a table.** The difference is that a table has to be trusted and a derivation can be checked.

<Aside type="tip">
**And the check found the error somewhere other than here.** The derivation reproduces **71 of the 72** names as they are usually published. The single divergence is position 25: circulating lists print נתע, the derivation gives נתה. The derivation is right, because the angel of that name is Nith-Haiah, נתהיה, which the published spelling cannot produce. The published list sits in our tests precisely so this stays visible.
</Aside>

Each name takes five degrees of the zodiac, six names per sign from 0° Aries. Look one up by index (`?index=1..72`) or by longitude (`?longitude=0..360`).

<Aside type="caution">
**What is deliberately absent:** the Latin transliterations of the angel names, the אל / יה suffixes, and any "birth angel" attribution from a chart. No source states these as a table with traceable provenance, and the transliterations differ between sources (Vehuiah against Vehujah, Jeliel against Yeliel). Inventing them would repeat what we already declined over thirty extra sahams. Every response carries an `absent` field that says so.
</Aside>

## The ten sephirot

A reference table: Hebrew, meaning, pillar, triad and the planetary attribution. **Nothing here is computed**, and the attribution is Hermetic Qabalah (Golden Dawn) rather than the Jewish mystical sources themselves, which assign no planets at all. The `attributionSet` field names the set so it can be swapped rather than assumed to be the only one.