Human Design

Create Human Design Chart

Generate a full Human Design bodygraph.

Free on every tier, including Explorer.

post/human-design/chart

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/human-design/chart
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Request body

birth_datetime_localstring

Naive local wall-clock birth datetime (YYYY-MM-DDTHH:MM:SS, no zone suffix), resolved by the server. Mutually exclusive with birth_datetime_utc — exactly one of the two is required. The zone comes from the sibling timezone field when supplied, otherwise from latitude/longitude; the historical-correction overlay is consulted for pre-1970 dates. The resolution is echoed back in the response metadata as tz_confidence / tz_rule_source / tz_resolved_offset / resolved_utc.

birth_datetime_utcstring date-time

Birth instant as an RFC 3339 datetime, e.g. '1987-07-15T14:01:00Z'. The caller has already done the timezone math, so the historical-correction overlay does not apply. Mutually exclusive with birth_datetime_local.

formatstring

Response format: json | llm.

include_chironboolean

Include Chiron gate mapping in the calculation.

include_lilithboolean

Include Black Moon Lilith gate mapping in the calculation.

include_visualboolean nullable

When true, a high-fidelity Human Design bodygraph SVG/PNG is embedded in the response alongside the data payload. Adds 2 credits to the request cost.

latitudenumber

Birth latitude in decimal degrees. Seeds timezone resolution for birth_datetime_local — with longitude it selects the IANA zone and lets the historical-correction overlay apply — and, where the endpoint renders one, positions the mandala house ring. Not read at all when birth_datetime_utc is used.

longitudenumber

Birth longitude in decimal degrees. Seeds timezone resolution for birth_datetime_local — with latitude it selects the IANA zone and lets the historical-correction overlay apply — and, where the endpoint renders one, positions the mandala house ring. Not read at all when birth_datetime_utc is used.

Example request

{
  "birth_datetime_local": "1985-03-20T08:15:00",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "timezone": {
    "iana_name": "America/Los_Angeles"
  }
}

Response

Successful Response

metadataobject required

Changes

No recorded changes to this operation across all 1 revision of this API.