Skip to content
96Astro API
Get API Key

Western astrology

Available

Planetary Returns API

Every return of Mercury, Venus, Mars, Jupiter or Saturn to its natal position in a date range, each retrograde pass listed separately, with a chart for each.

  • POST /v1/western/western-planetary-returns
  • 3 credits
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/western/western-planetary-returns \  -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,
      "planet": "Jupiter",
      "start_date": "2020-01-01",
      "end_date": "2035-12-31"
    }'

Overview

Every return of Mercury, Venus, Mars, Jupiter or Saturn to its natal position in a date range, each retrograde pass listed separately, with a chart for each.

Call it with POST /v1/western/western-planetary-returns. Input: birth details. Output: JSON, as a direct response. Each successful call costs 3 credits.

  • POST /v1/western/western-planetary-returns
  • 3 credits
  • 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 dataMeasured from 3 real answers to different inputs: a required field was in every one.

  • namestring
  • planetstring
  • natal_longitudenumber
  • natal_positionobject
  • rangeobject
  • locationobject
  • methodstring
  • countnumber
  • returnsarray of object
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 images are replaced by a placeholder.

Loading the example…

Request schema and every field: the Western astrology reference.

Related endpoints

FAQ

Planetary Returns API: common questions

4answers

Ask the team
01What does the Planetary Returns API return?

Every return of Mercury, Venus, Mars, Jupiter or Saturn to its natal position in a date range, each retrograde pass listed separately, with a chart for each. The response's data object includes name, planet, natal_longitude, natal_position, range, location, method and count. See the reference for an example response.

02What input does Planetary Returns need?

Birth details.

03How much does a Planetary Returns call cost?

3 credits 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.