visualization

Human Design Bodygraph

Generates a visually premium Human Design bodygraph (SVG or PNG).

post/visualization/bodygraph

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/visualization/bodygraph
  • 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

Query parameters

formatstring
sizeinteger
stylestring
show_variablesboolean
show_planet_columnsboolean
layoutstring

Composition. 'graph' (default) is the classic bodygraph with flanking planet columns. 'mandala' nests that same diagram inside concentric I Ching, quarter and zodiac rings on a square canvas.

ringsstring

Comma-separated optional mandala bands. Ignored unless layout=mandala. Omit for the default set (quarter,hexagrams,zodiac,planets); pass an empty value for none. Accepted: godhead, quarter, hexagrams, zodiac, planets. Note: 'godhead' uses Jovian Archive Rave Cosmology nomenclature and is off by default.

house_systemstring

House system for the mandala house ring. Only used when layout=mandala, rings includes 'houses', and latitude/longitude are supplied in the body. Accepts Placidus, Koch, Porphyry, Regiomontanus, Campanus, Equal, Whole Sign (codes or names). Quadrant systems substitute Porphyry at/within the polar circle (|lat| >= 90 - obliquity). Adds 1 credit when the house ring renders.

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

Changes

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