> ## 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).