API Documentation

Everything you need to integrate Human Design data into your application. Full chart calculations, relationship analysis, and transit data.

Authentication

All API requests require a Bearer token in the Authorization header. Get your API key from the API Marketplace.

authentication.sh

curl -X POST https://api.totalhumandesign.com/api/v1/data \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birthDate": "1990-05-15", "birthTime": "14:30", "birthLocation": "Manila, Philippines"}'

Base URL

https://api.totalhumandesign.com

Authentication Header

Authorization: Bearer thd_sk_xxxxxxxxxxxx

Error Responses

401

Unauthorized

Missing or invalid token

403

Forbidden

Token doesn't have access to this endpoint (e.g., V1 token accessing V2 endpoint)

429

Too Many Requests

Rate limit exceeded (demo endpoint only)

Request Format

All requests should use application/json content type. Dates should be in YYYY-MM-DD format, times in HH:MM 24-hour format.

Ready to Build?

Start integrating Human Design data into your application today.

Try Demo Free Get API Access