Back to Docs
Numerology Alphabets

Numerology Alphabet Registry

GET/api/v1/numerology/alphabets

Load the exact Latin, Cheiro, Hebrew Gematria, and Millui tables used by versioned numerology profiles, including normalization rules, final-form behavior, and letter-name expansions.

Full URL

https://api.freeastroapi.com/api/v1/numerology/alphabets

Immutable IDs are the contract

Resolve the alphabet_table_id returned by a profile or calculation rather than guessing from a system label. Cache definitions by registry_version + id. A different mapping must receive a different ID instead of silently changing an existing table.

Required header

Field
x-api-key
Type
string
Required
Yes
Description
Your FreeAstroAPI key. Missing and invalid keys return HTTP 401 and 403.

Example request

curl "https://api.freeastroapi.com/api/v1/numerology/alphabets" \
  -H "x-api-key: YOUR_API_KEY"

Response fields

Field
registry_version
Type
string
Required
n/a
Description
Version of the alphabet registry; currently 2026-07.
Field
alphabets
Type
array<object>
Required
n/a
Description
Complete immutable table definitions. Select objects by id rather than array position.
Field
alphabets[].id
Type
string
Required
n/a
Description
Stable table ID referenced by method profiles and result calculation_policy metadata.
Field
alphabets[].system
Type
string
Required
n/a
Description
Primary numerology system that owns the table.
Field
alphabets[].used_by_systems
Type
array<string>
Required
n/a
Description
Optional complete list of consumer systems, including the primary owner when present. For Cheiro this is chaldean and ank_jyotish; the field is omitted on the other current tables.
Field
alphabets[].profile_ids
Type
array<string>
Required
n/a
Description
Profiles that are frozen to this exact table.
Field
alphabets[].script
Type
ISO 15924
Required
n/a
Description
Latn or Hebr.
Field
alphabets[].direction
Type
ltr | rtl
Required
n/a
Description
Display/read direction for the source script.
Field
alphabets[].kind
Type
string
Required
n/a
Description
letter_values or letter_name_expansions.
Field
alphabets[].algorithm
Type
string
Required
n/a
Description
Machine-readable calculation family, for example cyclic_1_9, cheiro_1_8, or mispar_hechrechi.
Field
alphabets[].values
Type
object
Required
n/a
Description
Complete character-to-integer mapping, including Hebrew final forms.
Field
alphabets[].normalization
Type
string
Required
n/a
Description
Exact Unicode and character-retention policy applied before mapping.
Field
alphabets[].final_form_policy
Type
string
Required
n/a
Description
not_applicable or same_as_base.
Field
alphabets[].final_forms
Type
object
Required
n/a
Description
Hebrew final-form character to base-letter map.
Field
alphabets[].expansions
Type
object
Required
n/a
Description
Millui letter-name spellings; empty for direct letter-value tables.
Field
alphabets[].expansion_value_alphabet_id
Type
string
Required
n/a
Description
For Millui, the alphabet used to value every letter in each frozen expansion.
Field
alphabets[].notes
Type
array<string>
Required
n/a
Description
Method caveats such as missing value 9 or spelling variance.
Field
alphabets[].source_profile_version
Type
string
Required
n/a
Description
Source/method registry version associated with the definition.

Available alphabet IDs

pythagorean-latin-a-z-cyclic-1-9-v1
PythagoreanLatn · LTRcyclic_1_9

A-Z cycles through values 1-9. Used by both Pythagorean profiles.

cheiro-latin-1-8-v1
Chaldean + Ank JyotishLatn · LTRcheiro_1_8

Cheiro mapping from 1-8. No Latin letter receives the value 9.

hebrew-mispar-hechrechi-v1
KabbalahHebr · RTLmispar_hechrechi

Standard absolute values from 1 through 400; final forms use their base-letter value.

hebrew-mispar-siduri-v1
KabbalahHebr · RTLmispar_siduri

Ordinal Hebrew positions 1-22; final forms use their base-letter position.

hebrew-mispar-katan-v1
KabbalahHebr · RTLmispar_katan

Each standard Hebrew letter value is reduced to 1-9 before totals are summed.

hebrew-millui-alef-v1
KabbalahHebr · RTLmillui_alef

Frozen alef-filled letter-name spellings and their Hechrechi expansion totals.

Latin mapping overview

Pythagorean cyclic 1-9

1A J S
2B K T
3C L U
4D M V
5E N W
6F O X
7G P Y
8H Q Z
9I R

Cheiro 1-8

1A I J Q Y
2B K R
3C G L S
4D M T
5E H N X
6U V W
7O Z
8F P
9—

Hebrew normalization and final forms

  • Hebrew input uses NFKC normalization; niqqud/cantillation marks are removed and Hebrew letters are retained.
  • The final forms ך ם ן ף ץ map to the same base letters כ מ נ פ צ for Hechrechi, Siduri, Katan, and Millui.
  • Hechrechi returns standard values up to 400; Siduri returns ordinal positions 1-22; Katan reduces each letter to 1-9.
  • Millui expands each Hebrew character to a frozen letter-name spelling before valuing the expansion with Hechrechi.
  • Traditional Millui spellings vary. The ID hebrew-millui-alef-v1 deliberately freezes the alef-filled table; inspect expansions instead of assuming a spelling.

Complete Cheiro alphabet object

This is one complete alphabets[] object from the live registry.

{
  "id": "cheiro-latin-1-8-v1",
  "system": "chaldean",
  "used_by_systems": ["chaldean", "ank_jyotish"],
  "profile_ids": [
    "chaldean-cheiro-current-name-v1",
    "chaldean-cheiro-birth-name-v1",
    "ank-jyotish-civil-cheiro-navagraha-reduce-all-v1"
  ],
  "script": "Latn",
  "direction": "ltr",
  "kind": "letter_values",
  "algorithm": "cheiro_1_8",
  "values": {
    "A": 1, "I": 1, "J": 1, "Q": 1, "Y": 1,
    "B": 2, "K": 2, "R": 2,
    "C": 3, "G": 3, "L": 3, "S": 3,
    "D": 4, "M": 4, "T": 4,
    "E": 5, "H": 5, "N": 5, "X": 5,
    "U": 6, "V": 6, "W": 6,
    "O": 7, "Z": 7,
    "F": 8, "P": 8
  },
  "normalization": "NFKD, ligatures expanded, Latin A-Z retained",
  "final_form_policy": "not_applicable",
  "final_forms": {},
  "expansions": {},
  "notes": [
    "No letter is assigned the value 9.",
    "The table is reused by the explicit composite Ank Jyotish profile."
  ],
  "source_profile_version": "2026-07"
}

Client implementation notes

  • Use Unicode characters as object keys; do not transliterate Hebrew before looking up direct Gematria profiles.
  • Apply the published normalization policy before client-side previews, or treat the API result as authoritative.
  • Keep RTL presentation separate from arithmetic. Direction controls display, not summation order.
  • For audit screens, show the profile ID and alphabet ID alongside totals so users can reproduce a result.
  • Missing or invalid API keys return HTTP 401/403. Standard rate-limit responses can return HTTP 429.

Related endpoints

Numerology Profile

Calculate results with the selected alphabet ID recorded in metadata and trace details.

Method Registry

See which profiles and calculations are attached to each alphabet definition.