Western Yearly Forecast API
AvailableYear ahead from the solar return: the return moment and chart, the year's main transit themes with exact dates, and a summary.
Call it with POST /v1/western/western-yearly-forecast. Input: birth details. Output: JSON, as a direct response (json); pdf via /v1/jobs/pdf. Each successful call costs 10 credits.
- Endpoint
- POST /v1/western/western-yearly-forecast
- Input
- Birth details
- Output
- JSON
- Delivery
- Direct response (JSON); PDF via /v1/jobs/pdf
- Cost
- 10 credits
- Compute class
- Report
Example response
Fields in data (inferred from the example)
name· nulltarget_year· integerhouse_system· stringsun_sign· stringsolar_return· objectreturn_year· objectdominant_element· stringreturn_chart· objectthemes· array of objectthemes_method· stringsummary· string
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.
Western Yearly Forecast API: common questions
What does the Western Yearly Forecast API return?
Year ahead from the solar return: the return moment and chart, the year's main transit themes with exact dates, and a summary. The response's data object includes name, target_year, house_system, sun_sign, solar_return, return_year, dominant_element and return_chart. See the reference for an example response.
What input does Western Yearly Forecast need?
Birth details.
How much does a Western Yearly Forecast call cost?
10 credits 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.