Human Design

Planetary Opposition Chart

Calculate the Human Design chart at the moment a planet opposes its natal position (180°). Most commonly used for Uranus Opposition (~age 42), Saturn Opposition (~age 14-15, ~44), and Jupiter Opposition (~age 6, ~18, ~30).

post/human-design/cycles/opposition

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/human-design/cycles/opposition
  • 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'uranus' | 'saturn' | 'jupiter' required

Planet to calculate the opposition for.

target_yearinteger required

Year to search for the opposition 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.