The Human Design API for Developers

Natal charts, bodygraphs, transits, and AI-powered interpretations via simple REST. Production-ready, AGPL-3.0 licensed, used by practitioners worldwide.

Try it free → View source

Endpoints

Tiers

10K

req/min (Enterprise)

v1.0

Stable

Endpoints

All endpoints accept JSON. Authentication is required — pass your API key via the X-API-Key header.

POST

/v1/natal

Calculate a complete natal chart from birth data. Returns type, strategy, authority, profile, incarnation cross, defined channels, active gates, and centers.

POST

/v1/bodygraph

Generate a rendered SVG bodygraph visualization from birth data. Returns SVG markup ready to embed.

POST

/v1/transits

Calculate current planetary transits through the gates. Returns activated channels and gates for any moment.

GET

/ping

Health check. Returns API status, version, and license. No auth required.

Authentication

All /v1/* chart endpoints require an API key. Register a key below to get started.

API Key (Production)

# Register a key via dashboard
curl -X POST https://api.humandesignengine.com/v1/keys/register \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","name":"production"}'

# Use the key in subsequent requests
curl -X POST https://api.humandesignengine.com/v1/natal \
  -H "X-API-Key: hd_live_4vC9kM2pR7xL1nQ8wY3j..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Jane","year":1990,"month":6,"day":15,"hour":12,"minute":30,"city":"New York"}'

Try the API (Live Demo)

Enter your API key below — the form will POST to /v1/natal and render the response inline.

Response Format

{
  "success": true,
  "endpoint": "/v1/natal",
  "data": {
    "name": "Jane",
    "hd_type": "Manifesting Generator",
    "strategy": "To Respond",
    "authority": "Sacral",
    "profile": "2/4",
    "incarnation_cross": { "name": "Right Angle Cross of Eden" },
    "defined_centers": ["G", "Sacral", "Throat"],
    "all_active_gates": [1, 2, 6, 7, ...],
    "personality_gates": [1, 2, ...],
    "design_gates": [6, 36, ...]
  },
  "error": null
}

Pricing

Start free. Upgrade when you need higher rate limits, commercial use rights, or white-label capabilities.

Free

$0/mo

100 req/min

All chart endpoints
Personal projects
Community support
Commercial use
White-label

Pro

$49/mo

1,000 req/min

All chart endpoints
Commercial use
Email support
Uptime SLA: 99.5%
White-label

Enterprise

$499/mo

10,000 req/min

All chart endpoints
Commercial use
Priority support
Uptime SLA: 99.9%
White-label rights

Try It Live

Enter your API key and birth details to get a real natal chart response from the production API.

Click "Calculate Natal Chart" to see a live API response...