---
title: "Get Eclipse Path"
method: GET
path: "/eclipse/path/{eclipse_date}"
tags: ["eclipse"]
---

# Get Eclipse Path

`GET /eclipse/path/{eclipse_date}`

The path of totality as GeoJSON: centerline + limits + umbra band.

## Path parameters

- `eclipse_date` string, required

## Response `200`

Successful Response

- PathFeatureCollection — A standard GeoJSON FeatureCollection (extra top-level keys are ignored by Mapbox) with four features: centerline, north limit, south limit (Line or MultiLineString), and the umbra band (Polygon or MultiPolygon). The band is the true shadow footprint on the ellipsoid — it includes the sunrise/sunset hooks the axis-based centerline stops short of.
  - `type` string
  - `eclipse_date` string, required
  - `eclipse_type` string, required
  - `features` PathFeature[], required
    - `type` string
    - `geometry` GeoJSONGeometry, required
      - `type` string, required — LineString, MultiLineString, Polygon, or MultiPolygon. The Multi* variants appear when a geometry is split at the antimeridian (RFC 7946), so consumers must accept both the single and Multi forms.
      - `coordinates` unknown[], required
        - unknown
    - `properties` object, required

## 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)