Back to Docs
Numerology Methods

Numerology Method Registry

GET/api/v1/numerology/methods

Discover every supported numerology system, versioned profile, compatible policy combination, calculation slug, source, and request/response discriminator before constructing a profile request.

Full URL

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

Build from the registry, not from list order

Select systems by system and profiles by id. Cache the response by registry_version, but refresh when that version changes. Profile IDs and policy combinations are the stable integration contract; array order is not.

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/methods" \
  -H "x-api-key: YOUR_API_KEY"

Response fields

Field
registry_version
Type
string
Required
n/a
Description
Version of the complete method registry; currently 2026-07.
Field
systems
Type
array<object>
Required
n/a
Description
Supported systems. Do not infer a stable list order; select by systems[].system.
Field
systems[].system
Type
string
Required
n/a
Description
pythagorean, chaldean, kabbalah, or ank_jyotish.
Field
systems[].profiles
Type
array<object>
Required
n/a
Description
Versioned profile IDs with required fields, calculation slugs, alphabet table, descriptions, and allowed policy combinations.
Field
systems[].calculations
Type
array<object>
Required
n/a
Description
Calculation slugs, aliases, and method variance. Labels appear only where the system supplies them; resolve profile support through profiles[].calculation_slugs.
Field
systems[].master_policies
Type
array<string>
Required
n/a
Description
Master-number policies supported by the system.
Field
systems[].compound_policies
Type
array<string>
Required
n/a
Description
Evidence/reduction policies supported by the system.
Field
systems[].alphabet_ids
Type
array<string>
Required
n/a
Description
Immutable alphabet IDs that can be resolved through GET /alphabets.
Field
systems[].supported_name_scripts
Type
array<string>
Required
n/a
Description
Direct script and caller-supplied transliteration capabilities.
Field
systems[].interpretation_support
Type
object
Required
n/a
Description
Default behavior, content kinds, locale/version coverage, and honest unavailability or fallback policies.
Field
systems[].component_sources
Type
object
Required
n/a
Description
Ank Jyotish component-to-source mapping for Moolank, Bhagyank, Namank, graha metadata, and FreeAstro policy choices.
Field
systems[].graha_mapping
Type
object
Required
n/a
Description
Ank Jyotish 1-9 mapping with English, common romanization, IAST, Hindi names, and aliases.
Field
content_sources
Type
array<object>
Required
n/a
Description
Source registry with id, type, authority_class, title, usage, supports, and does_not_support, plus optional URL, locator, evidence, edition, and accessed_at fields.
Field
request_discriminator
Type
object
Required
n/a
Description
Declares method.system and its allowed values for request validation.
Field
response_discriminator
Type
object
Required
n/a
Description
Declares data.kind and its allowed values for response validation.

Profile families

pythagorean
pythagorean-component-preserve-core-v1pythagorean-raw-date-preserve-core-v1

17 slugs covering core numbers, personal cycles, life cycles, name analysis, karmic lessons, passions, and debts.

chaldean
chaldean-cheiro-current-name-v1chaldean-cheiro-birth-name-v1

chaldean_name_number with an explicit current- or birth-name basis.

kabbalah
kabbalah-gematria-hechrechi-v1kabbalah-gematria-siduri-v1kabbalah-gematria-katan-v1kabbalah-gematria-katan-mispari-v1kabbalah-gematria-millui-alef-v1kabbalah-gematria-millui-alef-reduced-v1

Simple, ordinal, per-letter reduced, total reduced, Millui, and reduced Millui Gematria.

ank_jyotish
ank-jyotish-civil-cheiro-navagraha-reduce-all-v1

Moolank, Bhagyank, and Namank with ruling-graha metadata.

Selected registry response

This valid excerpt highlights profile discovery and both discriminators. The live response also returns complete calculations, aliases, interpretation support, alphabet references, graha metadata, method warnings, and source records.

{
  "registry_version": "2026-07",
  "systems": [
    {
      "system": "pythagorean",
      "status": "supported",
      "profiles": [
        {
          "id": "pythagorean-component-preserve-core-v1",
          "required_fields": [
            "subject.birth_date",
            "date_context.reference_date OR subject.tz_str"
          ],
          "policy_combinations": [
            {
              "master_policy": "preserve_core_11_22_33",
              "compound_policy": "full_trace"
            }
          ]
        }
      ],
      "alphabet_ids": ["pythagorean-latin-a-z-cyclic-1-9-v1"],
      "supported_name_scripts": [
        "Latn",
        "non-Latin with caller-supplied Latin transliteration"
      ]
    },
    {
      "system": "chaldean",
      "profiles": [
        { "id": "chaldean-cheiro-current-name-v1", "name_source": "current" },
        { "id": "chaldean-cheiro-birth-name-v1", "name_source": "birth" }
      ]
    },
    {
      "system": "kabbalah",
      "profiles": [
        { "id": "kabbalah-gematria-hechrechi-v1" },
        { "id": "kabbalah-gematria-siduri-v1" },
        { "id": "kabbalah-gematria-katan-v1" },
        { "id": "kabbalah-gematria-katan-mispari-v1" },
        { "id": "kabbalah-gematria-millui-alef-v1" },
        { "id": "kabbalah-gematria-millui-alef-reduced-v1" }
      ]
    },
    {
      "system": "ank_jyotish",
      "profile_type": "explicit_composite_modern",
      "profiles": [
        {
          "id": "ank-jyotish-civil-cheiro-navagraha-reduce-all-v1",
          "birth_date_boundary": "civil_midnight",
          "calendar": "gregory",
          "date_digit_order": "DDMMYYYY",
          "oracle_corpus_id": "ank-jyotish-v1-oracles-2026-07"
        }
      ]
    }
  ],
  "request_discriminator": {
    "property_path": "method.system",
    "values": ["pythagorean", "chaldean", "kabbalah", "ank_jyotish"]
  },
  "response_discriminator": {
    "property_path": "data.kind",
    "values": ["pythagorean", "chaldean", "kabbalah", "ank_jyotish"]
  }
}

Recommended integration flow

  1. Fetch this registry during build, startup, or an admin configuration flow.
  2. Choose a profile ID and one of that profile's exact policy combinations.
  3. Use required_fields to render or validate system-specific input controls.
  4. Resolve every alphabet_table_id through the alphabet registry instead of copying a table from prose.
  5. Persist the chosen IDs with your result so later recalculation uses the same method contract.
  6. Refresh cached configuration when registry_version changes.

Authentication, errors, and caching

  • Missing x-api-key: HTTP 401 with ordinary JSON.
  • Invalid API key: HTTP 403 with ordinary JSON.
  • Standard account rate limits apply; handle HTTP 429 using the documented retry headers.
  • The registry contains no subject data and is safe to cache by registry_version.
  • Source URLs and locators are traceability metadata; they do not turn symbolic numerology claims into scientific findings.

Related endpoints

Numerology Profile

Submit a discriminated calculation request using one advertised profile.

Alphabet Registry

Resolve the immutable letter-value table referenced by a profile.