POST · WESTERN

Davison

Endpoint POST https://starsapi.com/api/v3/western/compatibility/davison

Overview

Computes the Davison relationship chart. Unlike the Composite (which averages the two charts’ positions), the Davison is an actual chart cast for the exact midpoint in time and space between the two births — so it behaves like a real natal chart of the relationship.

The response returns the davison_moment (the resolved midpoint date, time, and location, in UTC) together with the full chart computed for that moment: ascendant, midheaven, planets, house_cusps, and the aspects formed within the Davison chart (each with a short interpretation).

For the rendered wheel image, use davison-chart.

Authentication

MethodExample
Header (recommended)X-Api-Key: sa_live_xxxxxxxxxxxx
BearerAuthorization: Bearer sa_live_xxxxxxxxxxxx

Request body

Uses nested person1/person2 objects, each containing standard birth data:

FieldTypeRequiredDescription
person1.yearperson1.minuteintegerYesPerson 1 birth date & time.
person1.latitude, person1.longitudenumberYesPerson 1 birth location (decimal degrees).
person1.timezonestringYesPerson 1 IANA timezone.
person2.*YesSame fields for Person 2.
house_systemstringNoDefault placidus. Applied to the Davison chart.
node_typestringNoDefault true.

Response shape

FieldDescription
davison_momentResolved midpoint: datetime_utc, latitude/longitude, plus each partner’s birth moment (person_a_utc, person_b_utc).
ascendant, midheavenChart angles at the midpoint moment & place.
planetsFull positions (sign, degree, house, retrograde) for the Davison moment.
house_cuspsTwelve house cusps, keyed 112.
aspectsAspects within the Davison chart — planet1/planet2, aspect, orb, exactness_percent, nature, is_major, and a description.

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent in person1 or person2.
400INVALID_DATEInvalid date in either person.
500COMPUTE_ERRORMidpoint or positions computation failed.

See also