Total Human DesignDashboard|
Documentation

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:

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" },
  "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": [{ "gates": "1-8", "name": "Inspiration", "circuitry": "Individual" }],
  "personality": {
    "Sun": { "gate": 38, "line": 3, "color": 3, "tone": 2, "base": 3, "longitude": 294.12, "sign": "Capricorn" }
  },
  "design": { "..." : "..." },
  "phs": { "digestion": { "..." : "..." }, "environment": { "..." : "..." } },
  "ravePsychology": { "motivation": { "..." : "..." }, "perspective": { "..." : "..." } },
  "gates": { "definedGates": ["..."], "openGates": ["..."] },
  "astrology": { "houses": ["..."], "angles": { "..." : "..." } },
  "genetics": { "..." : "..." },
  "extras": { "chiron": { "..." : "..." }, "asteroids": { "..." : "..." } }
}
}

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