> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humandesignapi.nl/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/response-format), camelCase field names, and machine-readable [error codes](/api-reference/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](/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](/guides/plans-and-credits).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.