Skip to content
96Astro API
Get API Key

Western astrology

Available

Lunar Returns API

Every lunar return in a date range, each with its chart cast at the birth place or at return_place.

  • POST /v1/western/western-lunar-returns
  • 3 credits
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/western/western-lunar-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,
      "start_date": "2027-01-01",
      "end_date": "2027-03-31"
    }'

Overview

Every lunar return in a date range, each with its chart cast at the birth place or at return_place.

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

  • POST /v1/western/western-lunar-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 2 real answers to different inputs: a required field was in every one.

  • namestring
  • natal_moon_longitudenumber
  • 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

Lunar Returns API: common questions

4answers

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

Every lunar return in a date range, each with its chart cast at the birth place or at return_place. The response's data object includes name, natal_moon_longitude, range, location, method, count and returns. See the reference for an example response.

02What input does Lunar Returns need?

Birth details.

03How much does a Lunar 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.