v2 API Overview

Overview of the v2 Human Design Chart API.

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.