Human Design

Planetary Return Chart

Calculate a Human Design chart at the moment any planet returns to its natal longitude. Supports sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, chiron, and pholus.

post/human-design/cycles/return

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/human-design/cycles/return
  • 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 in the HD chart activations.

include_lilithboolean

Include Black Moon Lilith in the HD chart activations.

include_visualboolean

If true, a full visual SVG or PNG output will be rendered and returned alongside the chart data. Note: Visuals incur a +2 credit surcharge.

latitudenumber

Birth latitude in decimal degrees. With longitude it selects the IANA zone used to resolve birth_datetime_local, letting the historical-correction overlay apply. Not read when birth_datetime_utc is used.

longitudenumber

Birth longitude in decimal degrees. With latitude it selects the IANA zone used to resolve birth_datetime_local, letting the historical-correction overlay apply. Not read when birth_datetime_utc is used.

planet'sun' | 'moon' | 'mercury' | 'venus' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto' | 'chiron' | 'pholus' required

Planet to calculate the return for.

return_yearinteger required

Year to search for the return near.

Example request

{
  "birth_datetime_local": "1961-10-09T17:56:00",
  "timezone": {
    "iana_name": "America/New_York"
  }
}

Response

Successful Response

metadataobject required

Changes

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