Skip to main content
POST
Generate a chart from coordinates

Authorizations

Authorization
string
header
required

API key used as Bearer token in the Authorization header

Body

application/json
birthdate
string
required

Date of birth in YYYY-MM-DD format

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"1990-01-15"

birthtime
string
required

Time of birth in HH:MM format (24-hour)

Pattern: ^\d{2}:\d{2}$
Example:

"14:30"

lat
number<float>
required

Latitude of birth location

Required range: -90 <= x <= 90
Example:

52.3676

lng
number<float>
required

Longitude of birth location

Required range: -180 <= x <= 180
Example:

4.9041

Response

Chart generated successfully

Standard API response envelope wrapping all responses

timestamp
string<date-time>
required

ISO 8601 timestamp of response generation

Example:

"2026-03-24T12:00:00.000Z"

success
boolean
required

Whether the request succeeded

Example:

true

message
string
required

Human-readable success or error message

Example:

"Chart generated"

errorCode
string
required

Machine-readable error code (empty string on success)

Example:

""

type
string
required

Data type name of the object in the data field

Example:

"ChartResult"

data
object
required

Full Human Design chart with all properties