Quickstart

Get started with the Total Human Design API in just a few minutes.

1. Get your API key

Create an account and generate an API key from your 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 get populated educational descriptions.

Next steps