Skip to content
96Astro API

Western astrology

Available

Firdaria API

The firdaria (Persian-medieval planetary periods): the day or night sequence by the Sun's position, the 75-year cycle of major periods with dates, and the sub-periods in seven equal parts led by the major lord; give a date for the period in effect. Basis: Abu Ma'shar and Bonatti at text level; years of 365.25 days and no sub-periods for the node periods are conventions.

  • POST /v1/western/firdaria
  • 1 credit
Request
curl https://api.96astroapi.com/v1/western/firdaria \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "datetime": "1990-10-18T14:30:00",
      "timezone": "Asia/Kolkata",
      "latitude": 28.6139,
      "longitude": 77.209,
      "on_date": "2026-11-20"
    }'

Overview

The firdaria (Persian-medieval planetary periods): the day or night sequence by the Sun's position, the 75-year cycle of major periods with dates, and the sub-periods in seven equal parts led by the major lord; give a date for the period in effect. Basis: Abu Ma'shar and Bonatti at text level; years of 365.25 days and no sub-periods for the node periods are conventions.

Call it with POST /v1/western/firdaria. Input: birth details. Output: JSON, as a direct response. Each successful call costs 1 credit.

  • POST /v1/western/firdaria
  • 1 credit
  • Birth details

Try it

Runs the real calculation, free and without a key, a few times a minute. For more, and for AI readings, get a free sandbox key.

Response

Ready when you are

Press Run it to see the live response here.

Example response

Fields in dataInferred from the example response: a guide to the shape, not a contract.

  • julian_daynumber
  • utcstring
  • local_timestring
  • sectstring
  • sequencestring
  • cycle_yearsnumber
  • periodsarray of object
  • basisstring
  • notestring
  • on_datestring
  • currentobject
200Example response

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and image data is shortened.

Loading the example…

Request schema and every field: the Western astrology reference.

FAQ

Firdaria API: common questions

4answers

Ask the team
01What does the Firdaria API return?

The firdaria (Persian-medieval planetary periods): the day or night sequence by the Sun's position, the 75-year cycle of major periods with dates, and the sub-periods in seven equal parts led by the major lord; give a date for the period in effect. Basis: Abu Ma'shar and Bonatti at text level; years of 365.25 days and no sub-periods for the node periods are conventions. The response's data object includes julian_day, utc, local_time, sect, sequence, cycle_years, periods and basis. See the reference for an example response.

02What input does Firdaria need?

Birth details.

03How much does a Firdaria call cost?

1 credit per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.

04Can 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.

Send us feedback

What is it about?