Skip to main content

​
1. Get Your API Key

Sign up at humandesignapi.nl and choose a plan. Your API key will be available in the dashboard.

​
2. Get a Google Geocoding Key

The location-based endpoints use Google Geocoding to convert place names into coordinates. You need a Google Geocoding API key.
Don’t want a geocoding key? Use the coordinates endpoint instead — pass lat and lng directly.

​
3. Make Your First Request

curl -X POST https://api.humandesignapi.nl/v2/charts/simple \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "HD-Geocode-Key: YOUR_GEOCODE_KEY" \
  -d '{
    "birthdate": "1990-01-15",
    "birthtime": "14:30",
    "location": "Amsterdam, The Netherlands"
  }'

​
4. Understand the Response

All v2 responses use a standard envelope: 
{
  "timestamp": "2026-03-24T12:00:00.000Z",
  "success": true,
  "message": "Chart generated",
  "errorCode": "",
  "type": "ChartSimpleResult",
  "data": {
    "type": "Generator",
    "profile": "6/2",
    "gates": ["20", "34", "10", "57"],
    "channelsShort": ["20-34", "10-57"],
    "centers": ["G", "Sacral", "Spleen", "Throat"]
  }
}
FieldDescription
timestampISO 8601 timestamp of the response
successtrue if the request succeeded
messageHuman-readable status message
errorCodeMachine-readable error code (empty on success)
typeData type name (ChartSimpleResult or ChartResult)
dataThe chart data

​
Next Steps

Authentication

Deep dive into API key and geocoding key setup

Full Chart Endpoint

Get the complete chart with all properties

Response Format

Understand the standard response envelope

Error Handling

Handle errors gracefully