Next satellite passes over a target

Costs 2 token(s) per request. Propagates current orbital elements (SGP4 over day-cached CelesTrak two-line elements) and returns the access windows over a point for 13 families: Sentinel-1 (SAR), Sentinel-2, Landsat and NISAR are free and SYSTEMATIC (routinely collecting sensors — each pass is still a geometric opportunity, not a scheduled acquisition; units whose operator announced the end of operations are excluded); WorldView, ICEYE, Capella, SkySat, Umbra, Synspective, iQPS, RADARSAT-2 and COSMO-SkyMed are commercial and AGILE (taskable ACCESS opportunities that require a paid order — NOT guaranteed collects). Each pass carries acquisition/loss and closest-approach times, peak elevation, off-nadir angle, ground distance, ascending/descending, solar elevation and sunlit flag, plus the age of the element set used. Give lat and lon, or a bbox whose centre is used. The window is capped to a 7-day horizon. When orbital elements cannot be retrieved the response sets retrieval_ok:false — that means timing is UNAVAILABLE, never "no passes". Orbital data by CelesTrak.

get/api/v1/passes

Request

  • Base URL: https://offnadir-delta.com
  • URL: https://offnadir-delta.com/api/v1/passes
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

latnumber

Target latitude (-90..90; positive = North). Required unless bbox is given.

lonnumber

Target longitude (-180..180; positive = East). Required unless bbox is given.

bboxstring

Area as "west,south,east,north" (WGS84). The CENTRE is used as the target when lat/lon are omitted.

start_datestring date

Inclusive start date YYYY-MM-DD (UTC). Defaults to today.

end_datestring date

Inclusive end date YYYY-MM-DD (UTC). Defaults to start+2 days; capped to a 7-day horizon.

satellitesstring

Comma-separated family keys to consider: sentinel-1, sentinel-2, landsat, nisar, worldview, iceye, capella, skysat, umbra, synspective, iqps, radarsat-2, cosmo-skymed. Omit for all thirteen.

max_passesinteger

Maximum passes to return, soonest first (1..100, default 40).

Response

Access windows over the target, soonest first.

metaobject
retrieval_okboolean

false = orbital elements could not be retrieved; timing is unavailable, NOT "no passes".

total_passesinteger
by_familyobject
notestring
attributionstring

Mandatory CelesTrak credit.

Changes

No recorded changes to this operation across all 1 revision of this API.