Chart API

POST`/api/chart`Pro

Generate a complete Human Design chart from birth data. Returns type, authority, profile, gates, channels, centers, PHS, Variable, and full planetary positions.

Legacy URL

Also available at /api/v2/data — the legacy URL is still fully supported.

Request

See shared parameters for the full list. All chart endpoints accept birthDate, birthTime, birthLocation, and optional latitude/longitude overrides.

thd-api

Response

Response200

{
"success": true,
"meta": {
  "version": "2.0.0",
  "timestamp": "2026-03-15T12:00:00.000Z",
  "endpoint": "v2"
},
"data": {
  "birthInfo": {
    "date": "1990-05-15",
    "time": "14:30",
    "location": "New York, NY",
    "timezone": "America/New_York",
    "utcOffset": -4
  },
  "chart": {
    "type": "Generator",
    "strategy": "To Respond",
    "authority": "Sacral",
    "profile": "3/5",
    "definition": "Single",
    "incarnationCross": "Right Angle Cross of ...",
    "variable": "PLL DRR"
  },
  "centers": {
    "defined": ["sacral", "throat", "g"],
    "open": ["head", "ajna", "heart", "spleen", "solar_plexus", "root"]
  },
  "channels": [
    {
      "id": "1-8",
      "gates": "1-8",
      "name": "Inspiration",
      "circuitry": "Individual",
      "centers": ["G", "Throat"]
    }
  ],
  "gates": {
    "definedGates": ["1", "8", "..."],
    "hangingOpen": ["..."],
    "hangingClosed": ["..."],
    "openGates": ["..."]
  },
  "personality": {
    "Sun": {
      "activation": { "gate": 38, "line": 3, "color": 3, "tone": 2, "base": 3 },
      "astrology": { "longitude": 294.12, "sign": "Capricorn" },
      "genetics": { "..." : "..." }
    }
  },
  "design": { "Sun": { "..." : "..." } },
  "phs": {
    "digestion": { "..." : "..." },
    "environment": { "..." : "..." }
  },
  "ravePsychology": {
    "motivation": { "..." : "..." },
    "perspective": { "..." : "..." }
  },
  "extras": {
    "chiron": { "..." : "..." },
    "asteroids": { "..." : "..." }
  },
  "tooltips": {}
}
}

Response fields

Field	Description
`chart`	Core HD properties: type, strategy, authority, profile, definition, incarnation cross, variable
`centers`	Defined and open energy centers
`channels`	Active channels with gate pairs, name, circuitry, and connected centers
`gates`	Gates organized by status: defined, hanging open, hanging closed, open
`personality`	Conscious planetary positions with activation (gate/line/color/tone/base), astrology (longitude/sign), and genetics
`design`	Unconscious planetary positions (same structure as personality)
`phs`	Primary Health System — digestion and environment data
`ravePsychology`	Motivation and perspective from Rave Psychology
`extras`	Additional points: Chiron, asteroids, Lilith, Part of Fortune

Full response example

Example Response200

Complete chart response for a Generator born May 15, 1990 in New York

{
"success": true,
"meta": {
  "version": "2.0.0",
  "timestamp": "2026-03-20T12:00:00.000Z",
  "endpoint": "v2"
},
"data": {
  "birthInfo": {
    "date": "1990-05-15",
    "time": "14:30",
    "location": "New York, NY",
    "timezone": "America/New_York",
    "utcOffset": -4,
    "latitude": 40.7128,
    "longitude": -74.006
  },
  "chart": {
    "type": "Generator",
    "strategy": "To Respond",
    "authority": "Sacral",
    "profile": "3/5",
    "definition": "Single",
    "incarnationCross": "Right Angle Cross of Eden (12/11 | 36/6)",
    "variable": "PLL DRR"
  },
  "centers": {
    "defined": ["sacral", "throat", "g"],
    "open": ["head", "ajna", "heart", "spleen", "solar_plexus", "root"]
  },
  ...

Tooltip variant

POST`/api/chart?include=tooltips`Pro

Same chart data as /api/chart, enriched with educational descriptions in the tooltips field. Use this for user-facing content.

Legacy URL

Also available at /api/v2/data-tooltip — the legacy URL is still fully supported.

The tooltip variant returns an identical response structure with the tooltips field populated with full descriptions for every chart element — types, authorities, profiles, gates, channels, centers, and more.

When to use which

Use /api/chart for raw data processing and storage. Use /api/chart?include=tooltips when you need human-readable descriptions for a UI.