---
title: "Get Eclipse Climatology"
method: GET
path: "/eclipse/climatology"
tags: ["eclipse"]
---

# Get Eclipse Climatology

`GET /eclipse/climatology`

## Request

- Base URL: `https://stardrift.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://stardrift.ai/eclipse/climatology`
- Auth: none declared

Historical cloud odds at this point at its eclipse hour (slow, cache-warmed).

~5–30 s uncached (per-point ERA5 byte-range reads from the open-data bucket,
one +/-2-day window per year); the UI calls it async after the fast `/point`
dossier lands.

## Query parameters

- `lat` number, required: Latitude, decimal degrees, north-positive
- `lon` number, required: Longitude, decimal degrees, EAST-positive
- `eclipse_date` string, required: Eclipse date, YYYY-MM-DD

## Response `200`

Successful Response

- EclipseClimatologyResponse: 30-year cloud climatology at the point's local eclipse hour, with the site's eclipse geometry. `climatology.by_year` is the strip-chart series.
  - `eclipse_date` string, required
  - `latitude` number, required
  - `longitude` number, required
  - `eclipse_hour_utc` integer, required
  - `is_in_path` boolean, required
  - `local_type` string, required
  - `duration_seconds` number, nullable, required
  - `duration_display` string, nullable, required
  - `sun_altitude_deg` number, required
  - `climatology` CloudClimatology, required: 30-ish-year cloud-cover climatology at one place / calendar-date / hour.
    - `lat` number, required
    - `lon` number, required
    - `month` integer, required
    - `day` integer, required
    - `hour_utc` integer, required
    - `window_days` integer, required
    - `window_hours` integer, required
    - `p_clear` number, required
    - `p_cloud_below_25` number, required
    - `p_cloud_below_50` number, required
    - `p_cloud_below_75` number, required
    - `mean_total_cloud` number, required
    - `median_total_cloud` number, required
    - `mean_low_cloud` number, required
    - `mean_mid_cloud` number, required
    - `mean_high_cloud` number, required
    - `years_of_record` integer, required
    - `n_samples` integer, required
    - `by_year` YearCloudSummary[]
      - `year` integer, required
      - `mean_cloud` number, required
      - `n_samples` integer, required
    - `data_source` string
    - `license` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stardrift/apis/stardrift-api.md) - [All operations](https://skmtc.dev/stardrift/apis/stardrift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stardrift/apis/stardrift-api/revisions/be9ed1e6c38a?raw)