Synastry Aspects API
AvailableInter-chart aspects between two people, split into harmonious and challenging, with orb and meaning.
Call it with POST /v1/western/synastry-aspects. Input: two people's birth details. Output: JSON, as a direct response. Each successful call costs 1 credit.
- Endpoint
- POST /v1/western/synastry-aspects
- Input
- Two people's birth details
- Output
- JSON
- Delivery
- Direct response
- Cost
- 1 credit
- Compute class
- Standard
Example response
Fields in data (inferred from the example)
person_a· stringperson_b· stringtotal_inter_aspects· integerharmonious_aspects· array of objectchallenging_aspects· array of objectall_aspects· array of object
Example response
Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and images are replaced by a placeholder.
Loading the example…
Request schema and every field: the Western astrology reference.
Synastry Aspects API: common questions
What does the Synastry Aspects API return?
Inter-chart aspects between two people, split into harmonious and challenging, with orb and meaning. The response's data object includes person_a, person_b, total_inter_aspects, harmonious_aspects, challenging_aspects and all_aspects. See the reference for an example response.
What input does Synastry Aspects need?
Two people's birth details.
How much does a Synastry Aspects call cost?
1 credit per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.
Can I try it before paying?
Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.