Human Design

Solar Return Chart

Calculate a Solar Return Chart for a specific year. Determines exact moment Sun returns to natal degree, then runs a full chart.

post/human-design/cycles/solar-return

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/human-design/cycles/solar-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_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.

return_yearinteger required

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.