Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.humandesignapi.nl/llms.txt

Use this file to discover all available pages before exploring further.

v1 is supported but no longer recommended for new integrations. Use the v2 API instead. See the migration guide for upgrade instructions.

​
Base URL

https://api.humandesignapi.nl/v1

​
Authentication

v1 uses two custom headers (not Bearer token): 
HD-Api-Key: YOUR_API_KEY
HD-Geocode-Key: YOUR_GEOCODE_KEY
Both are required for all v1 endpoints.

​
Endpoints

EndpointDescriptionAccess Tier
POST /v1/bodygraphsFull bodygraph with all propertiesAdvanced
POST /v1/bodygraphs/simpleSimplified bodygraph (type, profile, gates, channels, centers)Basic + Advanced

​
Request Format

FieldTypeFormatExample
birthdatestringDD-MMM-YY"15-Jan-90"
birthtimestringHH:MM (24h)"14:30"
locationstringCity, Country (min 4 chars)"Amsterdam, The Netherlands"
v1 uses DD-MMM-YY date format (e.g., "15-Jan-90"). v2 uses ISO 8601 YYYY-MM-DD format.

​
Response Format

v1 returns chart data as a flat JSON object without a response envelope. Field names use snake_case: 
{
  "type": "Generator",
  "profile": "6/2",
  "channels_short": ["20-34", "10-57"],
  "centers": ["G", "Sacral", "Spleen", "Throat"],
  "strategy": "To Respond",
  "authority": "Sacral",
  "incarnation_cross": "Right Angle Cross of Tension (39/38 | 51/57)"
}

​
Key Differences from v2

Aspectv1v2
Auth headerHD-Api-KeyAuthorization: Bearer
Date formatDD-MMM-YYYYYY-MM-DD
ResponseFlat JSON objectStandard envelope with data field
Field namingsnake_casecamelCase
Error codesLimitedComprehensive, machine-readable
Coordinates endpointNot availableAvailable