Chart API

POST/api/chartPro

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

Request

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

thd-api

Response

✓ doneapplication/json

{
"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

200Example response

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=tooltipsPro

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

The tooltip variant returns an identical response structure. The tooltips field contains full descriptions for every chart element.

Usage

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