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

# Get Eclipse Path

`GET /eclipse/path/{eclipse_date}`

## Request

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

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