> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geometry.app/llms.txt
> Use this file to discover all available pages before exploring further.

# get_birthdate

> One birth date → birth card plus calendars, moon, season, retrogrades, and related systems.

<Badge color="green">Production</Badge>

<Info>
  **Status:** Production — most tested with [`get_compatibility`](/tools/get-compatibility). Formerly `get_card_for_birthdate`.
</Info>

One birth date in → birth card and layered systems for that date: tarot (minor + **dual major** Greer and Tarot School), medicine, Lenormand, runes, ogham, geomancy, sidereal wheels, moon phase, season, retrogrades, and more.

<Info>
  **One call returns** 26 symbolic systems across 20+ traditions — cards, tarot, five astrology wheels, numerology, chakras, moon phase, retrogrades, and multi-calendar years — as \~750 deterministic fields from a single date.
</Info>

|             |                                                                                                                                                                |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Input**   | `birth_date` (YYYY-MM-DD)                                                                                                                                      |
| **Range**   | `1900-01-01` … `2100-12-31` → `temporal_context: "full"`; nearby dates outside that window (e.g. 1850, 2101) → `"extended"`; farther out → `"birth_card_only"` |
| **Version** | `v2.8.0`                                                                                                                                                       |
| **MCP URL** | `https://mcp.geometry.app/mcp`                                                                                                                                 |

**Ask (summary):**

> Get the card for birthdate 1985-03-15.

**Ask (raw JSON / full payload):**

> give raw json for birthdate 1985-03-15 card

That phrase calls `get_birthdate` and tells the **agent** to paste the tool result verbatim (not summarize). There is still only one tool input: `birth_date`. “Raw JSON” and “full payload” are the same object.

The sample below is a **shortened teaching excerpt** (values from a live call). A full tool response for the same date includes every block (`medicine`, `lenormand`, full `astro_wheels`, full `retrogrades_active`, and the rest).

**Full payload / raw JSON:** the tool always returns the complete object. Read the MCP or HTTP response body in code. In chat, use the “raw json” line above so the model does not summarize.

## Example response

```json theme={null}
{
  "birth_date": "1985-03-15",
  "cosmic": {
    "card_no": 34,
    "suit_name": "diamonds",
    "suit_symbol": "♦",
    "unicard_name": "eight of diamonds",
    "unicard_symbol": "8♦",
    "ruling_planet": "mars",
    "unicard_emoji": "🃈",
    "word_groups": {
      "core": "concentration",
      "action": "acquire",
      "energy": "focus",
      "shadow": "obsession",
      "strength": "consolidation"
    },
    "classical_element": {
      "element_no": 1700,
      "element_name": "earth",
      "element_symbol": "🜃"
    },
    "periodic_element": {
      "element_no": 34,
      "atomic_no": 34,
      "element_name": "selenium",
      "element_symbol": "Se"
    }
  },
  "season": {
    "season_name": "winter",
    "prev_anchor_name": "winter_solstice",
    "prev_anchor_dt": "1984-12-21",
    "next_anchor_name": "spring_equinox",
    "next_anchor_dt": "1985-03-20",
    "days_since_prev": 84,
    "days_until_next": 5
  },
  "moon_phase": {
    "phase_name": "waning_crescent",
    "phase_type": "intermediate",
    "prev_anchor": "last_quarter",
    "next_anchor": "new_moon",
    "days_until_next": 6
  },
  "astro_wheels": {
    "tropical": {
      "sign_name": "pisces",
      "sign_symbol": "♓︎",
      "house": { "house_no": 12, "house_name": "twelfth house" },
      "ruling_planet": "poseidon",
      "body_part": "feet"
    },
    "sidereal_true": {
      "sign_name": "pisces",
      "system_slug": "sidereal_true"
    },
    "sidereal_iau": {
      "sign_name": "pisces",
      "system_slug": "sidereal_iau"
    },
    "fagan_bradley": {
      "sign_name": "aquarius",
      "system_slug": "fagan_bradley"
    },
    "vedic_rasi": {
      "sign_name": "pisces",
      "nakshatra": {
        "nakshatra_name": "revati",
        "pada_no": 3,
        "deity": "pushan"
      }
    }
  },
  "tarot": {
    "unicard_name": "eight of pentacles",
    "arcana_class": "minor",
    "tarot_no": 72
  },
  "tarot_birth_cards": {
    "greer": {
      "card_count": 1,
      "is_same_card": true,
      "personality": {
        "tarot_no": 5,
        "tarot_name": "the hierophant",
        "tarot_roman": "V",
        "tarot_symbol": "5★"
      },
      "soul": {
        "tarot_no": 5,
        "tarot_name": "the hierophant",
        "tarot_roman": "V",
        "tarot_symbol": "5★"
      },
      "hidden_factor": { "in_chain": false }
    },
    "tarot_school": {
      "card_count": 2,
      "is_19_chain": false,
      "major_1": {
        "tarot_no": 14,
        "tarot_name": "temperance",
        "tarot_roman": "XIV",
        "tarot_symbol": "14★"
      },
      "major_2": {
        "tarot_no": 5,
        "tarot_name": "the hierophant",
        "tarot_roman": "V",
        "tarot_symbol": "5★"
      },
      "major_3": { "in_chain": false }
    }
  },
  "medicine": {
    "card_no": 34,
    "deck_type": "medicine",
    "unicard_name": "grouse",
    "unicard_slug": "grouse",
    "unirank_code": "a",
    "unicard_symbol": "34↓"
  },
  "lenormand": {
    "card_no": 34,
    "deck_type": "lenormand",
    "unicard_name": "key",
    "unicard_slug": "key",
    "unicard_symbol": "8♦",
    "in_lenormand_tradition": true
  },
  "lunar": {
    "sign_name": "ox",
    "year_no": 1985,
    "han_symbol": "牛",
    "sign_emoji": "🐂"
  },
  "iching": {
    "iching_no": 34,
    "iching_name": "great_power",
    "glyph": "䷡",
    "pinyin": "da_zhuang"
  },
  "numerology": {
    "birth_day_no": 74,
    "lifepath_gregorian": 32,
    "lifepath_vedic": 28,
    "lifepath_hebrew": 28
  },
  "calendar_years": {
    "hebrew": { "year": 5745, "month": 6, "day": 22 },
    "persian": { "year": 1363, "month": 12, "day": 24 },
    "chinese": { "year_no": 1985 },
    "mayan": { "tzolkin_kin": 258, "longcount_kin": 1861857 },
    "vedic_saka": { "year": 1906 }
  },
  "calendar_meta": {
    "weekday": "friday",
    "week_no": 11,
    "is_weekend": false,
    "is_leap_year": false
  },
  "retrogrades_active": [
    {
      "planet_name": "pluto",
      "phase": "retrograde",
      "sign_tropical": "scorpio",
      "retro_start_dt": "1985-02-06",
      "retro_end_dt": "1985-07-12"
    },
    {
      "planet_name": "venus",
      "phase": "retrograde",
      "sign_tropical": "aries",
      "cazimi_dt": "1985-04-03",
      "retro_start_dt": "1985-03-13",
      "retro_end_dt": "1985-04-25"
    },
    {
      "planet_name": "saturn",
      "phase": "retrograde",
      "sign_tropical": "scorpio",
      "retro_start_dt": "1985-03-07",
      "retro_end_dt": "1985-07-25"
    }
  ],
  "norse_runes": {
    "rune_name": "berkano",
    "rune_glyph": "ᛒ",
    "sign_emoji": "🌱"
  },
  "celtic_ogham": {
    "sign_name": "nion",
    "ogham_glyph": "ᚅ",
    "tree_name": "nion"
  },
  "geomancy": {
    "figures": [
      { "geomancy_name": "laetitia", "geomancy_symbol": "𜻨" }
    ]
  },
  "temporal_context": "full"
}
```

Deck faces on the birth `card_no` include **`cosmic`**, **`tarot`** (minor map), **`medicine`**, and **`lenormand`**. Major Arcana birth cards live under **`tarot_birth_cards`** with **both** methods every call: **`greer`** (Mary K. Greer — common default) and **`tarot_school`** (Amberstone). Cultural glyph systems include **`norse_runes`**, **`celtic_ogham`**, and **`geomancy`**. The `retrogrades_active` array in this sample is shortened; a live response includes major planets, asteroids, TNPs, and points. A full response carries \~30 systems for one date.

Which numbers to build on: see the [Field glossary](/field-glossary). It separates tradition numbers like `card_no` and `tarot_no` from opaque catalog ids like `system_no`, and explains why `element_no` reads differently in the classical and periodic blocks.

## Out of published range

Dates outside 1900–2100 do not crash the tool. Birth-card identity still follows month/day.

| Band         | Example                    | `temporal_context` | Notes                                                                                |
| ------------ | -------------------------- | ------------------ | ------------------------------------------------------------------------------------ |
| **Extended** | `1850-06-15`, `2101-01-01` | `extended`         | Outside the published window — full temporal fields still returned, labeled honestly |
| **Out**      | `1776-07-04`, `2200-01-01` | `birth_card_only`  | Farther out — soft error envelope + birth card from month/day only                   |

## Related

* [get\_compatibility](/tools/get-compatibility) — two dates
* [get\_day](/tools/get-day) — calendar day (beta)
* [get\_name](/tools/get-name) — name → cosmic cards (beta)
* [Where your key goes](/connect-and-keys)
