POST/api/astro/rashifal/yearly/1 credit

Rashifal this year

This year's reading for one rashi, with every life aspect. EVERY ASPECT IS RETURNED ON EVERY CALL - general, career and business, love and relationships, money and finances, health, education and student, family, travel, business, and professionals. That is the difference from /api/astro/rashifal/, which returns a rotating sample of three or four aspects chosen by the date, so a page for one fixed aspect could not be built from it. Send `aspect` to get just one. Readings are deterministic: the same sign, period, aspect and date always return the same words, so a page can be cached and will not contradict itself when someone refreshes. `rashi` and `aspect` are case-insensitive. `date` defaults to today; for tomorrow and yesterday the offset is applied to the date you send. This is a sun-sign reading keyed to the Moon's transit, not a birth chart - it takes no birth time or place, and it is not a horoscope. Yearly also returns a quarterly forecast, the year's planetary movements, lucky elements and remedies.

https://api.occultapi.com/api/astro/rashifal/yearly/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

Field	Type	Required	Notes
rashi	string	required	Western sign name. Case-insensitive: Aries, aries and ARIES are all accepted. `ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspisces`
aspect	string	optional	Return only this aspect, in any case. Omit for all ten. * `general` - general * `career_business` - career_business * `love_relationships` - love_relationships * `money_finances` - money_finances * `health` - health * `education_student` - education_student * `family` - family * `travel` - travel * `business` - business * `professionals` - professionals
date	string (date)	optional	The day to read from. Defaults to today. For `tomorrow` and `yesterday` the offset is applied to this date, so sending 2026-09-16 to /tomorrow/ reads 2026-09-17.

Example request

This example is not yet verified

The field names and types below are taken from the API definition and are accurate, but this particular body has not returned a success when we last ran it — it may need a value we cannot infer. Treat it as a starting point rather than a working command.

curl -X POST https://api.occultapi.com/api/astro/rashifal/yearly/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rashi":"aries","date":"2026-09-01"}'

Response

A verified example response is not available for this endpoint yet. The request shape above is generated from the API definition and is accurate; we publish response samples only once we have proven them against a live call.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.