Quickstart

Authenticate and make your first request to the API.

1. Get your API key

Create an account and generate an API key in the dashboard.

2. Make your first request

Use your API key to generate a Human Design chart:

thd-api

3. Explore the response

The API returns a JSON envelope with success, meta, and data fields:

✓ 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" },
  "chart": {
    "type": "Generator",
    "strategy": "To Respond",
    "authority": "Sacral",
    "profile": "3/5",
    "definition": "Single",
    "incarnationCross": "Right Angle Cross of ...",
    "variable": "PLL DRR"
  },
  "centers": { "..." : "..." },
  "channels": [{ "gates": "1-8", "name": "Inspiration", "circuitry": "Individual" }],
  "gates": { "definedGates": ["..."], "openGates": ["..."] },
  "activations": { "..." : "..." },
  "personality": {
    "Sun": { "gate": 38, "line": 3, "color": 3, "tone": 2, "base": 3, "longitude": 294.12, "sign": "Capricorn" }
  },
  "design": { "..." : "..." },
  "phs": { "digestion": { "..." : "..." }, "environment": { "..." : "..." } },
  "ravePsychology": { "motivation": { "..." : "..." }, "perspective": { "..." : "..." } },
  "tooltips": { "..." : "..." }
}
}
Chart properties live under data.chart

Type, strategy, authority, profile, definition and related properties are nested under `data.chart` — not at the top of `data`. For astrology houses, angles and asteroids (Chiron, Lilith, Part of Fortune, AC/MC/IC/DC) use `POST /api/astrology`. The former `data.extras` field was removed on 2026-06-01.

V2 response format

V2 responses return chart properties as raw strings (e.g. "type": "Generator"). Add ?include=tooltips (e.g. /api/chart?include=tooltips) to include educational descriptions.

Next steps