v2 API Overview

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

Endpoint	Description	Access Tier	Geocode Key
`POST /v2/charts`	Full chart with all properties	Advanced	Required
`POST /v2/charts/simple`	Simplified chart (type, profile, gates, channels, centers)	Basic + Advanced	Required
`POST /v2/charts/coordinates`	Full chart from latitude/longitude	Advanced	Not needed

Request Format

All endpoints accept application/json with:

Field	Type	Format	Example
`birthdate`	string	`YYYY-MM-DD`	`"1990-01-15"`
`birthtime`	string	`HH:MM` (24h)	`"14:30"`
`location`	string	City, 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.

v2 Endpoints (Recommended)

v1 Endpoints (Legacy)

Reference

Base URL

Authentication

Endpoints

Request Format

Content Type

Credits

​Base URL

​Authentication

​Endpoints

​Request Format

​Content Type

​Credits

Base URL

Authentication

Endpoints

Request Format

Content Type

Credits