Quick Start

1. Get Your API Key

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"
  }'

const response = await fetch("https://api.humandesignapi.nl/v2/charts/simple", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY",
    "HD-Geocode-Key": "YOUR_GEOCODE_KEY",
  },
  body: JSON.stringify({
    birthdate: "1990-01-15",
    birthtime: "14:30",
    location: "Amsterdam, The Netherlands",
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.humandesignapi.nl/v2/charts/simple",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY",
        "HD-Geocode-Key": "YOUR_GEOCODE_KEY",
    },
    json={
        "birthdate": "1990-01-15",
        "birthtime": "14:30",
        "location": "Amsterdam, The Netherlands",
    },
)

data = response.json()
print(data)

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"]
  }
}

Field	Description
`timestamp`	ISO 8601 timestamp of the response
`success`	`true` if the request succeeded
`message`	Human-readable status message
`errorCode`	Machine-readable error code (empty on success)
`type`	Data type name (`ChartSimpleResult` or `ChartResult`)
`data`	The 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

Getting Started

Guides

Migration

1. Get Your API Key

2. Get a Google Geocoding Key

3. Make Your First Request

4. Understand the Response

Next Steps

Authentication

Full Chart Endpoint

Response Format

Error Handling

​1. Get Your API Key

​2. Get a Google Geocoding Key

​3. Make Your First Request

​4. Understand the Response

​Next Steps

Authentication

Full Chart Endpoint

Response Format

Error Handling

1. Get Your API Key

2. Get a Google Geocoding Key

3. Make Your First Request

4. Understand the Response

Next Steps