Zodiac sign pair relations (public, no key)
All 78 unordered pairs of zodiac signs (each sign with itself included), each with the classical whole-sign relation: same, sextile, square, trine, opposition, or aversion for signs one or five apart, which classically do not see each other. tone follows Ptolemy (Tetrabiblos I.13): trine, sextile and same sign are harmonious, square and opposition challenging, aversion neutral. There is deliberately no 0-100 score: a pair of signs has no orb and no bodies for the synastry model to weigh, so any number would be invented. For a score, send two birth charts to POST /public/synastry. Static data, Cache-Control: public, max-age=604800, Vary: Accept-Language. localized (follows ?lang= / Accept-Language) holds lookup tables from the English identifiers in pairs to display names: signs, relations, tones, elements, modalities. The identifiers themselves never change.
Query parameters
Language for this call, overriding Accept-Language. The canonical per-call form: a page that renders in one language passes it here rather than reconfiguring its client. Unknown or inactive codes fall back to uk.
Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.
Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.
Headers
BCP-47 language (e.g. uk, en, de). Set it once on your HTTP client as its default; for a single call, ?lang= overrides it. Unknown or inactive codes fall back to uk.
Response
OK
Example response
{
"ok": true,
"_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}Changes
Changed in 2 of the 29 revisions of this API.4
- ○
added the new optional
headerrequest parameterAccept-Languagenew-optional-request-parameter
- ○
added the new optional
queryrequest parameterlangnew-optional-request-parameter
- ○
added the optional property
/to the response with the statusresponse-optional-property-added
- ○
- ○
endpoint added
endpoint-added
- ○