Developer-ready numerology calculations

Free Numerology API Four Systems. One API.

Add Pythagorean, Chaldean, Kabbalah/Gematria, and Ank Jyotish calculations to your app with one versioned JSON contract. Start with the system and required subject data; the API resolves the recommended method and returns calculation provenance your code can trust.

View Documentation

80 free requests per day. No credit card required.

Built for numerology apps and developer workflows

Numerology methods vary. The API keeps those differences explicit while giving frontend and backend teams one predictable integration surface.

One Profile Endpoint

Use one POST contract across four numerology systems instead of maintaining separate integrations and response parsers.

Typed, Auditable Results

Receive a data.kind discriminator, normalized input, versioned methods, raw totals, compounds, roots, and optional full traces.

Names Across Scripts

Send structured birth or current names with script and transliteration metadata, including direct Hebrew Gematria input.

No Calculation Persistence

The calculation endpoint does not persist submitted names, dates, or derived results, and reports that policy in every success.

Choose the tradition your product needs

Each response is discriminated by data.kind, so your application can narrow the result to the correct system-specific shape.

Pythagorean

Western profiles and personal cycles

pythagorean

Build complete birth-date profiles, current-cycle features, and optional birth-name analysis from one structured request.

Needs: Birth date. Add a birth name for name numbers and a reference date or timezone for current cycles.

Returns: Life Path, Birthday, Attitude, personal cycles, pinnacles, challenges, and optional name analysis.

Chaldean / Cheiro

Compound and root name numbers

chaldean

Calculate a Cheiro-style number for the name a person currently uses or the name supplied at birth.

Needs: One current or birth name. Non-Latin input needs a caller-supplied Latin transliteration.

Returns: An auditable compound and root calculated with the immutable Cheiro 1-8 alphabet table.

Kabbalah / Gematria

Direct Hebrew name arithmetic

kabbalah

Support Hebrew-name Gematria with a recommended default and explicitly versioned traditional calculation variants.

Needs: One direct Hebrew birth or current name. The API can infer the Hebrew script for unambiguous input.

Returns: A profile-specific Gematria total, root, normalized input, and optional calculation trace.

Ank Jyotish

Indian numerology app workflows

ank_jyotish

Create Indian numerology features with civil-date arithmetic, name numbers, localized labels, and planetary rulers.

Needs: Gregorian birth date and one birth or current name. Non-Latin input needs Latin transliteration.

Returns: Moolank, Bhagyank, Namank, and versioned 1-9 ruling-graha metadata with Hindi-ready labels.

Copy-ready quick starts

Make your first request in minutes

Pick a method and language. Every sample below is a minimal valid production request, with no registry lookup or long profile identifier required.

POST/api/v1/numerology/profilex-api-key1 request

curl -X POST "https://api.freeastroapi.com/api/v1/numerology/profile" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  --data '{
  "method": {
    "system": "pythagorean"
  },
  "subject": {
    "birth_date": "1992-07-16"
  },
  "date_context": {
    "reference_date": "2026-07-15"
  }
}'

Abridged response

Numbers your code can explain

The response keeps the applied tradition and arithmetic visible. You can display a friendly value such as 17/8 while retaining the exact raw total, compound, canonical value, and root behind it.

Versioned method metadata

Log or pin the exact profile and policies returned in meta.method.

Stable numeric semantics

Keep unreduced compounds and roots distinct instead of flattening every method into one integer.

Optional full trace

Request reduction paths and character-level evidence when your product needs an audit view.

200 · application/json

{
  "meta": {
    "schema_version": "2.0",
    "method": {
      "system": "pythagorean",
      "profile": "pythagorean-component-preserve-core-v1",
      "master_policy": "preserve_core_11_22_33",
      "compound_policy": "compound_and_root"
    },
    "privacy": {
      "persisted": false,
      "retention": "none_by_numerology_endpoint",
      "request_data_stored_by_endpoint": false
    }
  },
  "data": {
    "kind": "pythagorean",
    "core": {
      "life_path": {
        "raw_total": 17,
        "compound": 17,
        "value": 8,
        "root": 8,
        "value_display": "17/8"
      },
      "birthday": {
        "value_display": "16/7"
      },
      "attitude": {
        "value_display": "23/5"
      }
    }
  }
}

Numerology building blocks for your app

Use the calculation layer behind consumer tools, member profiles, daily experiences, or specialist numerology products.

Profile onboarding

Turn a birth date and optional name into structured numerology profile data for onboarding, dashboards, and saved-user experiences.

Daily cycle features

Power personal year, month, and day experiences with an explicit date anchor or the same AUTO timezone workflow used by natal calculation.

Name calculators

Create current-name, birth-name, Chaldean, and Hebrew Gematria tools without hard-coding alphabet tables in every client.

Indian numerology UI

Build Moolank, Bhagyank, Namank, and ruling-graha experiences with English and Hindi-ready metadata.

Calculation first, prose only when requested

Interpretations are off by default. Pythagorean and bounded Chaldean English content can be enabled; Kabbalah returns a method explanation rather than a universal personal meaning. Ank Jyotish returns deterministic calculations and graha metadata without interpretation prose.

Free Numerology API FAQ

Is there a free numerology API for developers?

Yes. FreeAstroAPI includes a free tier with 80 requests per day at one request per second, and no credit card is required. It is intended for development and prototypes; commercial plans are available when an app moves to production traffic.

Which numerology systems does the API support?

The profile endpoint supports Pythagorean, Chaldean/Cheiro, Kabbalah/Gematria, and Ank Jyotish. Send method.system and the API resolves the recommended versioned profile and compatible policies for that system.

What information does each numerology request need?

Pythagorean needs a birth date. Chaldean needs one current or birth name. Kabbalah needs one direct Hebrew name. Ank Jyotish needs a Gregorian birth date and one name. The documentation shows the smallest valid request for every system.

Can I audit how a numerology number was calculated?

Yes. Normal responses preserve raw totals, compounds, roots, display values, normalized input, and the resolved method. Select full_trace when you also need reduction steps or character-level evidence supported by the chosen method.

Does the numerology endpoint store names or birth dates?

The numerology calculation endpoint does not persist submitted names, dates, or derived results. Every successful response exposes this endpoint-level policy in meta.privacy. Authentication, quota, and platform-security operations are separate.

Are numerology interpretations included automatically?

No. Interpretations are opt-in and off by default. Pythagorean and bounded Chaldean English content is available; Kabbalah can return a method explanation rather than a universal personal meaning. Ank Jyotish returns calculations and graha metadata without interpretation prose.

Ship your numerology feature faster

Start with a free API key, copy one minimal request, and move to a commercial plan when your application is ready for production traffic.

Explore Numerology Docs

No credit card required for the free tier.