Human Design API

Generate complete Human Design charts from birth data. The API calculates planetary positions using the Swiss Ephemeris and maps them to the Human Design system.

Endpoints

Endpoint	Description
Chart API	Full chart calculation — type, authority, profile, gates, channels, centers, PHS, Variable
Composite	Relationship chart between two people — connection channels and dynamics
Western Astrology	Traditional Western astrology — planets, signs, houses, aspects, angles

All endpoints require the Advanced Chart API product.

Shared request parameters

All Human Design endpoints accept the same birth data parameters:

Parameters

Parameter	Type	Required	Description
`birthDate`	string	Yes	Date of birth in YYYY-MM-DD format
`birthTime`	string	Yes	Time of birth in HH:MM (24-hour) format
`birthLocation`	string	Yes	City and region (e.g. "New York, NY"). Used for timezone and coordinate lookup.
`latitude`	number	No	Override latitude. Skips geocoding when provided with longitude.
`longitude`	number	No	Override longitude. Skips geocoding when provided with latitude.

When latitude and longitude are provided, the API skips location geocoding and uses the coordinates directly. The timezone is still resolved from coordinates using an offline database.

Location resolution is fully offline — no external geocoding services are called. The response includes a birthInfo.resolvedCity field showing which city was matched, so you can verify the lookup. Use the Validate Location endpoint to pre-check city names before making a calculation call.

Tooltip variants

Add ?include=tooltips to any chart endpoint to get the same data enriched with educational descriptions. Use the base endpoint for raw data and add tooltips for user-facing content.

Endpoint	With tooltips
`POST /api/chart`	`POST /api/chart?include=tooltips`
`POST /api/composite`	`POST /api/composite?include=tooltips`
`POST /api/astrology`	`POST /api/astrology?include=tooltips`