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

# Get Eclipse Climatology

`GET /eclipse/climatology`

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/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)