Skip to content
96Astro API
Get API Key

Western astrology

Available

Electional Search API

Scores a date range at a place by traditional electional rules (void-of-course Moon, waxing Moon, Mercury, Venus and Mars retrograde, Venus and Jupiter or Mars and Saturn on an angle, the Moon's dignity and its applying aspects) and returns the best windows, each with its score in named parts and the reasons, plus the Moon's void-of-course periods.

  • POST /v1/western/western-electional
  • 3 credits
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/western/western-electional \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "start_date": "2026-12-01",
      "days": 7,
      "timezone": "America/New_York",
      "latitude": 40.7128,
      "longitude": -74.006
    }'

Overview

Scores a date range at a place by traditional electional rules (void-of-course Moon, waxing Moon, Mercury, Venus and Mars retrograde, Venus and Jupiter or Mars and Saturn on an angle, the Moon's dignity and its applying aspects) and returns the best windows, each with its score in named parts and the reasons, plus the Moon's void-of-course periods.

Call it with POST /v1/western/western-electional. Input: date and place. Output: JSON, as a direct response. Each successful call costs 3 credits.

  • POST /v1/western/western-electional
  • 3 credits
  • Date and place

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.

  • start_datestring
  • daysnumber
  • latitudenumber
  • longitudenumber
  • timezonestring
  • step_minutesnumber
  • pointsobject
  • moments_scorednumber
  • moon_void_of_coursearray of object
  • windowsarray 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

Electional Search API: common questions

4answers

Ask the team
01What does the Electional Search API return?

Scores a date range at a place by traditional electional rules (void-of-course Moon, waxing Moon, Mercury, Venus and Mars retrograde, Venus and Jupiter or Mars and Saturn on an angle, the Moon's dignity and its applying aspects) and returns the best windows, each with its score in named parts and the reasons, plus the Moon's void-of-course periods. The response's data object includes start_date, days, latitude, longitude, timezone, step_minutes, points and moments_scored. See the reference for an example response.

02What input does Electional Search need?

Date and place.

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