POST/v1/western/eclipses

Eclipses

Solar and lunar eclipses in a date range, past or future, up to 10 years. Each gives the type, time of greatest eclipse, start and end (UTC) and the eclipse degree in the tropical zodiac (Swiss Ephemeris). Add birth data to get, for each eclipse, the natal planets and angles within 3° of the eclipse degree by conjunction or opposition. Without a birth time the Ascendant and MC are skipped and the natal Moon is approximate.

Request parameters

from_daterequired

string

First day of the range (YYYY-MM-DD, UTC).

to_daterequired

string

Last day of the range (YYYY-MM-DD, UTC, inclusive). At most 10 years after from_date.

birthoptional

BirthInput | null

Optional birth data. When given, each eclipse lists natal planets and angles within 3° of the eclipse degree.

house_systemoptional

string

House system used to compute the natal Ascendant and MC.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.from_date

string

data.to_date

string

data.orb_degrees

number

Orb used for natal contacts.

data.birth_data_provided

boolean

data.birth_time_provided

boolean

False when no birth time: Ascendant and MC are not checked and the natal Moon is approximate.

data.angles_checked

boolean

True when the natal Ascendant and MC were included in the contact check.

data.eclipses

array[object]

data.eclipses[].kind

string

data.eclipses[].type

string

Solar: total, annular, hybrid or partial. Lunar: total, partial or penumbral.

data.eclipses[].max_utc

string

Moment of greatest eclipse, UTC.

data.eclipses[].begin_utc

string | null

Start of the eclipse (partial phase; penumbral phase for penumbral lunar eclipses), UTC.

data.eclipses[].end_utc

string | null

End of the eclipse, UTC.

data.eclipses[].sun_longitude

number

Tropical longitude of the Sun at maximum.

data.eclipses[].moon_longitude

number

Tropical longitude of the Moon at maximum.

data.eclipses[].eclipse_longitude

number

The eclipse degree: Sun for a solar eclipse, Moon for a lunar one.

data.eclipses[].sign

string

data.eclipses[].sign_index

integer

data.eclipses[].degree_in_sign

number

data.eclipses[].natal_contacts

array[object]

Natal points within 3° of the eclipse degree (empty without birth data).

data.eclipses[].natal_contacts[].natal_point

string

Natal planet, Ascendant or MC.

data.eclipses[].natal_contacts[].natal_longitude

number

data.eclipses[].natal_contacts[].aspect

string

How the eclipse degree meets the natal point: same degree (conjunction) or opposite (opposition).

data.eclipses[].natal_contacts[].orb

number

Distance from exact, in degrees (0–3).

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Biorhythm Cycles
• Western Moon Phase
• Western Moon Phase Calendar
• Planetary hours
• Void-of-course Moon
• Western day view

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/western/eclipses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from_date":"2026-01-01","to_date":"2026-12-31","birth":{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}}'

Python

import asterwise
from asterwise.api.western_astrology_api import WesternAstrologyApi
from asterwise.models.eclipses_request import EclipsesRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = EclipsesRequest(
    from_date="2026-01-01",
    to_date="2026-12-31",
    birth={'name': 'Arjun Mehta', 'date': '1985-11-12', 'time': '06:45', 'latitude': 19.076, 'longitude': 72.8777, 'timezone': 'Asia/Kolkata'},
)

with asterwise.ApiClient(configuration) as client:
    api = WesternAstrologyApi(client)
    result = api.western_eclipses(eclipses_request=request)
    print(result)

TypeScript

import { createClient, createConfig, westernEclipses } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await westernEclipses({
  client,
  body: {
      "from_date": "2026-01-01",
      "to_date": "2026-12-31",
      "birth": {
        "name": "Arjun Mehta",
        "date": "1985-11-12",
        "time": "06:45",
        "latitude": 19.076,
        "longitude": 72.8777,
        "timezone": "Asia/Kolkata"
      }
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "from_date": "2026-01-01",
    "to_date": "2026-12-31",
    "orb_degrees": 3.0,
    "birth_data_provided": true,
    "birth_time_provided": true,
    "angles_checked": true,
    "eclipses": [
      {
        "kind": "solar",
        "type": "annular",
        "max_utc": "2026-02-17T12:11:53Z",
        "begin_utc": "2026-02-17T09:56:47Z",
        "end_utc": "2026-02-17T14:27:39Z",
        "sun_longitude": 328.836412,
        "moon_longitude": 328.927037,
        "eclipse_longitude": 328.836412,
        "sign": "Aquarius",
        "sign_index": 10,
        "degree_in_sign": 28.836412,
        "natal_contacts": []
      },
      {
        "kind": "lunar",
        "type": "total",
        "max_utc": "2026-03-03T11:33:41Z",
        "begin_utc": "2026-03-03T09:50:05Z",
        "end_utc": "2026-03-03T13:17:17Z",
        "sun_longitude": 342.895215,
        "moon_longitude": 162.85925,
        "eclipse_longitude": 162.85925,
        "sign": "Virgo",
        "sign_index": 5,
        "degree_in_sign": 12.85925,
        "natal_contacts": []
      },
      "... and 2 more items"
    ]
  }
}