Servers Playground How we check Submit a server

Numerology MCP Server by RoxyAPI

Working · 255 ms

com.roxyapi/numerologyv1.0.1 Domain verified

Life Path, Expression, karmic debt and Chaldean numerology readings for AI agents.

Entertainment & Games

Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://roxyapi.com/mcp/numerology

X-API-Key (required)

RoxyAPI key from roxyapi.com/account

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_numerology_compound_number

Get the classical Chaldean meaning of a compound number, also called a fadic number, from 10 to 52 as Cheiro defines it. A compound number is the unreduced two-digit total behind a name or date, read beside its single-digit root. The response returns the root, the nature (fortunate, unfortunate or mixed), the full interpretation in the language set by lang, and the symbolic name where Cheiro gives one, such as The Wheel of Fortune for 10 or The Crown of the Magi for 21; a number from 33 up that repeats a lower one carries a sameAs pointer to it. Built for Chaldean numerology references, name analysis tools and AI agents.

numberstring, required

Compound number from 10 to 52.

langstring

Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.

compactboolean

Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

Numerology MCP Server by RoxyAPI MCP server | mcptry

Numerology MCP Server by RoxyAPI

Working · 255 ms

com.roxyapi/numerologyv1.0.1 Domain verified

Life Path, Expression, karmic debt and Chaldean numerology readings for AI agents.

Entertainment & Games

Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://roxyapi.com/mcp/numerology

X-API-Key (required)

RoxyAPI key from roxyapi.com/account

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_numerology_compound_number

numberstring, required

Compound number from 10 to 52.

langstring

compactboolean

Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

Tools (20)

Tool list last changed Oct 23, 2026.

get_numerology_compound_number

read-only

Argument	Type	Description
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
number*	string	Compound number from 10 to 52.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "number": "23"
    }
  ],
  "required": [
    "number"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "number": {
      "type": "string",
      "example": "23",
      "pattern": "^(1\\d|2\\d|3\\d|4\\d|5[0-2])$",
      "description": "Compound number from 10 to 52."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    }
  }
}

get_numerology_meanings_number

Get the full numerology meaning of any number 1 to 9 or the master numbers 11, 22 and 33. The response returns the archetype title, keywords, a core description, strengths, challenges, career, relationships and spirituality in the language set by lang, the same reading every core number endpoint returns for that number. Built for numerology reference pages, custom calculators, educational apps and AI agents.

read-only

Argument	Type	Description
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
number*	string	Numerology number (1-9, 11, 22, 33)
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "number": "5"
    }
  ],
  "required": [
    "number"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "number": {
      "type": "string",
      "example": "5",
      "pattern": "^(1|2|3|4|5|6|7|8|9|11|22|33)$",
      "description": "Numerology number (1-9, 11, 22, 33)"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    }
  }
}

post_numerology_birth_day

Calculate the Birth Day number from the day of the month a person was born, 1 to 31, with Pythagorean numerology. The 11th, 22nd and 29th keep the master numbers 11 and 22, other two-digit days reduce to one digit, and the 13th, 14th, 16th and 19th are flagged as karmic debt with their meaning. The response returns the calculation and a full interpretation of the special talents the day brings in the language set by lang. Built for birthday features, talent and career discovery tools, and AI agents.

read-only

Argument	Type	Description
day*	integer	Day of birth (1-31)
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "day": 23
    }
  ],
  "required": [
    "day"
  ],
  "properties": {
    "day": {
      "type": "integer",
      "example": 23,
      "maximum": 31,
      "minimum": 1,
      "description": "Day of birth (1-31)"
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    }
  }
}

post_numerology_bridge

Calculate four numerology Bridge numbers from a full birth name and birth date: Life Path and Expression, Expression and Soul Urge, Soul Urge and Personality, and Expression and Personality. Each bridge is the distance between two core numbers, from 0 to 8, where 0 means the two are already in harmony, and comes with guidance for closing the gap in the language set by lang. Built for personal development, coaching and personality analysis tools and AI agents.

read-only

Argument	Type	Description
day*	integer	Birth day (1 to 31)
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
year*	integer	Birth year between 100 and 2100. Used to calculate the Life Path number via Pythagorean reduction.
month*	integer	Birth month (1 to 12)
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.
fullName*	string

post_numerology_business_name

Analyze a business or brand name with Chaldean numerology, the system practitioners use for trade names. The name is read word by word, and the response returns the compound number and root with every step, the planetary ruler, a business rating, the industries the number favors, whether the compound is one of the fortunate compounds Cheiro names, and guidance, in the language set by lang. The roots 1, 3, 5 and 6 rate excellent, 2 and 9 good, 7 and 8 caution and 4 avoid. Built for naming tools, brand agencies and founder apps; the rating is positioning guidance, not a guarantee.

read-only

Argument	Type	Description
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
name*	string	The business or brand name to evaluate. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "name": "Ford"
    }
  ],
  "required": [
    "name"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "name": {
      "type": "string",
      "example": "Ford",
      "maxLength": 200,
      "minLength": 1,
      "description": "The business or brand name to evaluate. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    }
  }
}

post_numerology_chaldean

Calculate a complete Chaldean numerology reading for a name, following Cheiro. The Destiny or name number, the Soul Urge from the vowels and the Personality from the consonants each come with the compound number from 10 to 52, the single-digit root and the classical compound interpretation, and a longer name is read name by name with every step shown in its calculation. The response adds the planetary ruler and meaning of the Destiny root, a caution flag for the roots 4 and 8, and a summary, in the language set by lang. Built for Chaldean numerology calculators, name analysis tools and AI agents.

read-only

Argument	Type	Description
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
name*	string	The name to analyze. Chaldean tradition uses the name a person is most known by, not necessarily the full legal birth name. It needs at least one vowel (A, E, I, O, U) and one consonant, since the Soul Urge is read from the vowels and the Personality from the consonants; Y counts as a consonant. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

post_numerology_chart

Generate a complete numerology chart from a full birth name and birth date in one call. It returns the six core numbers (Life Path, Expression, Soul Urge, Personality, Birth Day and Maturity) with their calculations and full interpretations, the four Pinnacles and four Challenges with their ages, Karmic Lessons, karmic debt in all five positions, Hidden Passion, Subconscious Self, Cornerstone, Capstone and First Vowel, the Birth Day profile for the exact day, lucky associations, the Maturity activation status, the Personal Year with the current Personal Month, and a written summary, in the language set by lang. The Personal Year uses currentYear or the current UTC year, while the Personal Month and the age behind the Maturity status read the current UTC date. Built for full numerology readings, PDF reports, onboarding profiles and AI agents.

read-only

Argument	Type	Description
day*	integer	Birth day (1-31)
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
year*	integer	Birth year between 100 and 2100. Supports historical figures like Einstein (1879) and Shakespeare (1564).
month*	integer	Birth month (1-12)
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

post_numerology_compatibility

Calculate numerology compatibility between two people from their Life Path, Expression and Soul Urge numbers. Send each person as a full birth name with a birth date, or as precomputed numbers, and mix the two modes freely across the pair. The response returns an overall score from 50 to 100 with its rating, a score and description for each number pair, and the strengths, challenges and advice for the relationship, in the language set by lang. Built for dating apps, matchmaking, relationship coaching and AI companions.

read-only

Argument	Type	Description
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.
person1*	object
person2*	object

Input schema (JSON)

{
  "type": "object",
  "required": [
    "person1",
    "person2"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "person1": {
      "type": "object",
      "properties": {
        "day": {
          "type": "integer",
          "example": 15,
          "maximum": 31,
          "minimum": 1,
          "description": "Birth day (1-31). Required with year and month for automatic Life Path calculation."
        },
        "year": {
          "type": "integer",
          "example": 1990,
          "maximum": 2100,
          "minimum": 100,
          "description": "Birth year to calculate Life Path automatically. Use with month and day instead of passing lifePath directly."
        },
        "month": {
          "type": "integer",
          "example": 7,
          "maximum": 12,
          "minimum": 1,
          "description": "Birth month (1-12). Required with year and day for automatic Life Path calculation."
        },
        "fullName": {
          "type": "string",
          "example": "John William Smith",
          "maxLength": 200,
          "minLength": 1,
          "description": "Full birth name to calculate Expression and Soul Urge numbers automatically. Use instead of passing expression and soulUrge directly."
        },
        "lifePath": {
          "type": "integer",
          "example": 5,
          "maximum": 33,
          "minimum": 1,
          "description": "Person 1 Life Path number (1-9, 11, 22, 33). Optional if year, month, day are provided."
        },
        "soulUrge": {
          "type": "integer",
          "example": 6,
          "maximum": 33,
          "minimum": 1,
          "description": "Person 1 Soul Urge number (1-9, 11, 22, 33). Optional if fullName is provided."
        },
        "expression": {
          "type": "integer",
          "example": 7,
          "maximum": 33,
          "minimum": 1,
          "description": "Person 1 Expression number (1-9, 11, 22, 33). Optional if fullName is provided."
        }
      },
      "x-required-any-of": [
        [
          "fullName",
          "year",
          "month",
          "day"
        ],
        [
          "lifePath",
          "expression",
          "soulUrge"
        ]
      ]
    },
    "person2": {
      "type": "object",
      "properties": {
        "day": {
          "type": "integer",
          "example": 22,
          "maximum": 31,
          "minimum": 1,
          "description": "Birth day (1-31). Required with year and month for automatic Life Path calculation."
        },
        "year": {
          "type": "integer",
          "example": 1992,
          "maximum": 2100,
          "minimum": 100,
          "description": "Birth year to calculate Life Path automatically. Use with month and day instead of passing lifePath directly."
        },
        "month": {
          "type": "integer",
          "example": 3,
          "maximum": 12,
          "minimum": 1,
          "description": "Birth month (1-12). Required with year and day for automatic Life Path calculation."
        },
        "fullName": {
          "type": "string",
          "example": "Jane Marie Doe",
          "maxLength": 200,
          "minLength": 1,
          "description": "Full birth name to calculate Expression and Soul Urge numbers automatically. Use instead of passing expression and soulUrge directly."
        },
        "lifePath": {
          "type": "integer",
          "example": 3,
          "maximum": 33,
          "minimum": 1,
          "description": "Person 2 Life Path number (1-9, 11, 22, 33). Optional if year, month, day are provided."
        },
        "soulUrge": {
          "type": "integer",
          "example": 2,
          "maximum": 33,
          "minimum": 1,
          "description": "Person 2 Soul Urge number (1-9, 11, 22, 33). Optional if fullName is provided."
        },
        "expression": {
          "type": "integer",
          "example": 9,
          "maximum": 33,
          "minimum": 1,
          "description": "Person 2 Expression number (1-9, 11, 22, 33). Optional if fullName is provided."
        }
      },
      "x-required-any-of": [
        [
          "fullName",
          "year",
          "month",
          "day"
        ],
        [
          "lifePath",
          "expression",
          "soulUrge"
        ]
      ]
    }
  }
}

post_numerology_daily

Get the numerology Number of the Day, one of 1 to 9, 11, 22 or 33, with its full interpretation. The same seed returns the same number for the same date, so a user keeps one number all day, and the date defaults to today in UTC. The response returns the number, its type, a daily message and the archetype, keywords, strengths, challenges, career, relationships and spirituality reading in the language set by lang. Built for Number of the Day widgets, push notifications and daily content.

read-only

Argument	Type	Description
date	string	Date for the reading in YYYY-MM-DD format. Defaults to today (UTC). Useful for viewing past daily readings or pre-generating future ones.
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
seed	string	Optional seed for reproducible readings. Same seed + same date = same number every time. Pass any unique identifier (userId, email hash, session token) to give each user their own number for the day. Without a seed every caller receives the same shared number of the day.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-03-06",
      "description": "Date for the reading in YYYY-MM-DD format. Defaults to today (UTC). Useful for viewing past daily readings or pre-generating future ones."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "seed": {
      "type": "string",
      "example": "user123",
      "description": "Optional seed for reproducible readings. Same seed + same date = same number every time. Pass any unique identifier (userId, email hash, session token) to give each user their own number for the day. Without a seed every caller receives the same shared number of the day."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    }
  }
}

post_numerology_dual

Calculate a name number in both Pythagorean and Chaldean numerology in one call and compare them. The Pythagorean side returns the Expression or Destiny number with master numbers 11, 22 and 33 kept; the Chaldean side returns the compound number from 10 to 52, the root, its planetary ruler and the compound interpretation; each shows its calculation name by name. An agreement flag and a plain-language note show whether the two systems point to the same single-digit energy, in the language set by lang. Built for system comparison tools, name analysis features and AI agents.

read-only

Argument	Type	Description
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
name*	string	The name to analyze in both systems. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "name": "David"
    }
  ],
  "required": [
    "name"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "name": {
      "type": "string",
      "example": "David",
      "maxLength": 200,
      "minLength": 1,
      "description": "The name to analyze in both systems. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    }
  }
}

post_numerology_expression

Calculate the Expression number, also called the Destiny number, from a full birth name with Pythagorean numerology. Every letter is valued and the name is reduced name by name, with master numbers 11, 22 and 33 kept and a karmic debt of 13, 14, 16 or 19 flagged with its meaning. The response lists every letter value and returns a full interpretation of natural talents, career, relationships and spiritual path in the language set by lang. Built for name numerology apps, career and personal brand tools, and AI agents.

read-only

Argument	Type	Description
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.
fullName*	string	Full birth name (first, middle, last). A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "fullName": "John William Smith"
    }
  ],
  "required": [
    "fullName"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "fullName": {
      "type": "string",
      "example": "John William Smith",
      "maxLength": 200,
      "minLength": 1,
      "description": "Full birth name (first, middle, last). A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses."
    }
  }
}

post_numerology_karmic_debt

Detect Karmic Debt numbers 13, 14, 16 and 19 across the five core numbers that carry them: Life Path, Expression, Soul Urge, Personality and Birth Day. Send a birth date, a full birth name, or both, and only the positions those inputs reach are read; each debt is listed once with its challenge and resolution guidance in the language set by lang. Built for spiritual growth apps, karmic readings, coaching tools and AI agents.

read-only

Argument	Type	Description
day	integer	Birth day (checks Birth Day on its own, and Life Path with year and month)
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
year	integer	Birth year (checks Life Path)
month	integer	Birth month (checks Life Path)
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.
fullName	string	Full birth name (checks Expression, Soul Urge, Personality). A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.

post_numerology_karmic_lessons

Analyze the Karmic Lessons of a full birth name with Pythagorean numerology: the numbers 1 to 9 that no letter of the name carries. Each missing number is returned with its lesson, a fuller explanation and practical guidance for developing it, in the language set by lang, beside the count of letters behind every number present. Built for spiritual growth apps, coaching tools, full numerology reports and AI agents.

read-only

Argument	Type	Description
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.
fullName*	string	Full birth name to analyze for missing numbers. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "fullName": "John William Smith"
    }
  ],
  "required": [
    "fullName"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "fullName": {
      "type": "string",
      "example": "John William Smith",
      "maxLength": 200,
      "minLength": 1,
      "description": "Full birth name to analyze for missing numbers. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses."
    }
  }
}

post_numerology_life_path

Calculate a Life Path number from a birth date with Pythagorean numerology. The Life Path is the core number of a numerology chart, read from the birth year, month and day alone, with master numbers 11, 22 and 33 kept and a karmic debt of 13, 14, 16 or 19 flagged with its meaning. The response returns every reduction step and a full interpretation (archetype title, keywords, description, strengths, challenges, career, relationships and spirituality) in the language set by lang. Built for Life Path calculators, numerology apps, onboarding personality profiles and AI agents.

read-only

Argument	Type	Description
day*	integer	Birth day (1-31)
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
year*	integer	Birth year between 100 and 2100. Supports historical figures like Einstein (1879) and Shakespeare (1564).
month*	integer	Birth month (1-12)
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

Input schema (JSON)

post_numerology_maturity

Calculate the Maturity number, also called the Realization number, from the Life Path and Expression numbers with Pythagorean numerology. Send a full birth name and birth date, the two numbers precomputed, or one of each; master numbers 11, 22 and 33 are kept at full value and in the result. The Maturity number describes who a person grows into in the second half of life, usually felt from around 35 to 40, and the response returns the calculation and a full interpretation in the language set by lang. Built for life coaching apps, midlife and later-life guidance, and AI agents.

read-only

Argument	Type	Description
day	integer	Birth day (1-31). Required with year and month for automatic Life Path calculation.
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
year	integer	Birth year to calculate Life Path automatically. Use with month and day instead of passing lifePath directly.
month	integer	Birth month (1-12). Required with year and day for automatic Life Path calculation.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

post_numerology_personal_day

Calculate the Personal Day number from a birth month and day with Pythagorean numerology, the 1 to 9 theme of a single calendar day personalized to the birthday. The day is targetDate, or today in UTC when omitted. The response returns the day theme and guidance with the parent Personal Month and Personal Year, in the language set by lang. Built for daily push notifications, morning briefings, calendar widgets and AI agents.

read-only

Argument	Type	Description
day*	integer	Birth day (1-31)
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
month*	integer	Birth month (1-12)
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.
targetDate	string	Target date in YYYY-MM-DD format, in the years 100 to 2100. Defaults to today (UTC).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "day": 18,
      "month": 7
    }
  ],
  "required": [
    "month",
    "day"
  ],
  "properties": {
    "day": {
      "type": "integer",
      "example": 18,
      "maximum": 31,
      "minimum": 1,
      "description": "Birth day (1-31)"
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "month": {
      "type": "integer",
      "example": 7,
      "maximum": 12,
      "minimum": 1,
      "description": "Birth month (1-12)"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "targetDate": {
      "type": "string",
      "format": "date",
      "example": "2026-04-04",
      "description": "Target date in YYYY-MM-DD format, in the years 100 to 2100. Defaults to today (UTC)."
    }
  }
}

post_numerology_personal_month

Calculate the Personal Month number from a birth month and day with Pythagorean numerology, the 1 to 9 theme of one calendar month inside the Personal Year. The year and month are the ones sent, each defaulting to the current UTC year and month when omitted. The response returns the month theme, practical focus and the parent Personal Year with its theme, in the language set by lang. Built for monthly forecast features, push notifications, editorial columns and AI agents.

read-only

Argument	Type	Description
day*	integer	Birth day (1-31)
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
year	integer	Target year. Defaults to the current UTC year.
month*	integer	Birth month (1-12)
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.
targetMonth	integer	Target calendar month to forecast (1 to 12). Defaults to the current UTC month.

post_numerology_personal_year

Calculate the Personal Year number from a birth month and day with Pythagorean numerology, the 1 to 9 cycle that sets the theme of a calendar year. The year is the one sent, or the current UTC year when omitted, and it turns over on 1 January; the birth year is not needed. The response returns the place in the nine-year cycle, the theme, a forecast, opportunities, challenges and advice in the language set by lang. Built for yearly planning features, New Year content, coaching tools and AI agents.

read-only

Argument	Type	Description
day*	integer	Birth day (1-31)
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
year	integer	Year to forecast. Defaults to the current UTC year; the Personal Year turns over on 1 January.
month*	integer	Birth month (1-12)
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "day": 15,
      "month": 7
    }
  ],
  "required": [
    "month",
    "day"
  ],
  "properties": {
    "day": {
      "type": "integer",
      "example": 15,
      "maximum": 31,
      "minimum": 1,
      "description": "Birth day (1-31)"
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 2025,
      "maximum": 2100,
      "minimum": 100,
      "description": "Year to forecast. Defaults to the current UTC year; the Personal Year turns over on 1 January."
    },
    "month": {
      "type": "integer",
      "example": 7,
      "maximum": 12,
      "minimum": 1,
      "description": "Birth month (1-12)"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    }
  }
}

post_numerology_personality

Calculate the Personality number from the consonants of a full birth name with Pythagorean numerology. Every letter other than A, E, I, O and U is a consonant, Y and W included; master numbers 11, 22 and 33 are kept and a karmic debt of 13, 14, 16 or 19 is flagged with its meaning. The response lists every consonant name by name and returns a full interpretation of first impressions, public image, career and relationships in the language set by lang. Built for personal branding apps, social and dating profiles, coaching tools and AI agents.

read-only

Argument	Type	Description
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.
fullName*	string	Full birth name. Its consonants give the Personality number, so a name with none is refused. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "fullName": "John William Smith"
    }
  ],
  "required": [
    "fullName"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "fullName": {
      "type": "string",
      "example": "John William Smith",
      "maxLength": 200,
      "minLength": 1,
      "description": "Full birth name. Its consonants give the Personality number, so a name with none is refused. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses."
    }
  }
}

post_numerology_soul_urge

Calculate the Soul Urge number, also called the Heart Desire number, from the vowels of a full birth name with Pythagorean numerology. A, E, I, O and U are the vowels and Y and W count as consonants; master numbers 11, 22 and 33 are kept and a karmic debt of 13, 14, 16 or 19 is flagged with its meaning. The response lists every vowel name by name and returns a full interpretation of inner motivation, relationships and spiritual path in the language set by lang. Built for self-discovery apps, dating profiles, coaching tools and AI agents.

read-only

Argument	Type	Description
lang	string	Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.
compact	boolean	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.
fullName*	string	Full birth name. Its vowels A, E, I, O and U give the Soul Urge, so a name with none is refused. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "fullName": "John William Smith"
    }
  ],
  "required": [
    "fullName"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "fullName": {
      "type": "string",
      "example": "John William Smith",
      "maxLength": 200,
      "minLength": 1,
      "description": "Full birth name. Its vowels A, E, I, O and U give the Soul Urge, so a name with none is refused. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "day": 15,
      "year": 1990,
      "month": 7,
      "fullName": "John William Smith"
    }
  ],
  "required": [
    "fullName",
    "year",
    "month",
    "day"
  ],
  "properties": {
    "day": {
      "type": "integer",
      "example": 15,
      "maximum": 31,
      "minimum": 1,
      "description": "Birth day (1 to 31)"
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 1990,
      "maximum": 2100,
      "minimum": 100,
      "description": "Birth year between 100 and 2100. Used to calculate the Life Path number via Pythagorean reduction."
    },
    "month": {
      "type": "integer",
      "example": 7,
      "maximum": 12,
      "minimum": 1,
      "description": "Birth month (1 to 12)"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "fullName": {
      "type": "string",
      "example": "John William Smith",
      "maxLength": 200,
      "minLength": 1,
      "description": "Full birth name as it appears on the birth certificate, first, middle and last names separated by spaces. Used to calculate the Expression, Soul Urge and Personality numbers. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "name": "Helen"
    }
  ],
  "required": [
    "name"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "name": {
      "type": "string",
      "example": "Helen",
      "maxLength": 200,
      "minLength": 1,
      "description": "The name to analyze. Chaldean tradition uses the name a person is most known by, not necessarily the full legal birth name. It needs at least one vowel (A, E, I, O, U) and one consonant, since the Soul Urge is read from the vowels and the Personality from the consonants; Y counts as a consonant. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "day": 15,
      "year": 1990,
      "month": 7,
      "fullName": "John William Smith"
    }
  ],
  "required": [
    "fullName",
    "year",
    "month",
    "day"
  ],
  "properties": {
    "day": {
      "type": "integer",
      "example": 15,
      "maximum": 31,
      "minimum": 1,
      "description": "Birth day (1-31)"
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 1990,
      "maximum": 2100,
      "minimum": 100,
      "description": "Birth year between 100 and 2100. Supports historical figures like Einstein (1879) and Shakespeare (1564)."
    },
    "month": {
      "type": "integer",
      "example": 7,
      "maximum": 12,
      "minimum": 1,
      "description": "Birth month (1-12)"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "fullName": {
      "type": "string",
      "example": "John William Smith",
      "maxLength": 200,
      "minLength": 1,
      "description": "Full birth name as it appears on the birth certificate. Used for every letter-based number in the chart: Expression, Soul Urge, Personality, Karmic Lessons, Hidden Passion, Subconscious Self and the special letters. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses."
    },
    "currentYear": {
      "type": "integer",
      "example": 2025,
      "maximum": 2100,
      "minimum": 100,
      "description": "Calendar year for the Personal Year, defaults to the current UTC year. It moves the Personal Year only: the nested personalMonth and maturityStatus.currentAge always read the current UTC date."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "day": 15,
      "year": 1990,
      "month": 7
    }
  ],
  "required": [
    "year",
    "month",
    "day"
  ],
  "properties": {
    "day": {
      "type": "integer",
      "example": 15,
      "maximum": 31,
      "minimum": 1,
      "description": "Birth day (1-31)"
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 1990,
      "maximum": 2100,
      "minimum": 100,
      "description": "Birth year between 100 and 2100. Supports historical figures like Einstein (1879) and Shakespeare (1564)."
    },
    "month": {
      "type": "integer",
      "example": 7,
      "maximum": 12,
      "minimum": 1,
      "description": "Birth month (1-12)"
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "day": {
      "type": "integer",
      "example": 15,
      "maximum": 31,
      "minimum": 1,
      "description": "Birth day (1-31). Required with year and month for automatic Life Path calculation."
    },
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English."
    },
    "year": {
      "type": "integer",
      "example": 1990,
      "maximum": 2100,
      "minimum": 100,
      "description": "Birth year to calculate Life Path automatically. Use with month and day instead of passing lifePath directly."
    },
    "month": {
      "type": "integer",
      "example": 7,
      "maximum": 12,
      "minimum": 1,
      "description": "Birth month (1-12). Required with year and day for automatic Life Path calculation."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens."
    },
    "fullName": {
      "type": "string",
      "example": "John William Smith",
      "maxLength": 200,
      "minLength": 1,
      "description": "Full birth name to calculate the Expression number automatically. Use instead of passing expression directly. A name in any script is converted to Latin letters before it is counted, Cyrillic and Greek as the passport spelling and accents folded to the base letter, and the calculation lists the letters counted. For a script that does not write its vowels, send the Latin spelling the person uses."
    },
    "lifePath": {
      "type": "integer",
      "example": 5,
      "maximum": 33,
      "minimum": 1,
      "description": "Your Life Path number (1-9, 11, 22, 33). Optional if year, month, day are provided."
    },
    "expression": {
      "type": "integer",
      "example": 7,
      "maximum": 33,
      "minimum": 1,
      "description": "Your Expression number (1-9, 11, 22, 33). Optional if fullName is provided."
    }
  }
}