Skip to main content
The v2 API is the recommended version for all new integrations. It returns structured JSON with a consistent response envelope, camelCase field names, and machine-readable error codes.

​
Base URL

https://api.humandesignapi.nl/v2

​
Authentication

All endpoints require an API key as a Bearer token: 
Authorization: Bearer YOUR_API_KEY
Location-based endpoints additionally require a geocoding key: 
HD-Geocode-Key: YOUR_GEOCODE_KEY
See Authentication for details.

​
Endpoints

EndpointDescriptionAccess TierGeocode Key
POST /v2/chartsFull chart with all propertiesAdvancedRequired
POST /v2/charts/simpleSimplified chart (type, profile, gates, channels, centers)Basic + AdvancedRequired
POST /v2/charts/coordinatesFull chart from latitude/longitudeAdvancedNot needed

​
Request Format

All endpoints accept application/json with:
FieldTypeFormatExample
birthdatestringYYYY-MM-DD"1990-01-15"
birthtimestringHH:MM (24h)"14:30"
locationstringCity, Country (4-200 chars)"Amsterdam, The Netherlands"
The coordinates endpoint replaces location with lat (number, -90 to 90) and lng (number, -180 to 180).

​
Content Type

Content-Type: application/json

​
Credits

Each successful API call costs 1 credit. See Plans & Credits.