> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Satellite Passes
> List when each imaging satellite with a published orbit was or will be over a point in a window of up to 48 hours, and whether its sensor swath covered the point.
Lists when imaging satellites were or will be over a point; only published orbits are covered. observed is the satellite and orbit the source published; every pass figure is derived by SGP4 (rise\_at, culminate\_at, set\_at, max\_elevation\_deg, daynight, cut\_by\_window, track\_distance\_km, in\_swath). in\_swath true means the sensor could have seen the point; it does not mean an image was taken or released.
Orbital elements courtesy of CelesTrak (celestrak.org), from US government sources. The pass times are computed by OneShot, not published by CelesTrak.
## Authentication
Requires x402 payment in the `payment-signature` header.
## Request Body
**latitude** `number` *required*
Latitude in decimal degrees, for example 34.05. From -90 to 90.
**longitude** `number` *required*
Longitude in decimal degrees (west is negative), for example -118.25. From -180 to 180.
**from** `string`
Start of the window, ISO 8601 UTC such as 2026-10-28T00:00:00Z or 2026-10-28; default 24 hours before the call.
**to** `string`
End of the window, ISO 8601 UTC, at most 48 hours after from and within 3 days of the call; default 24 hours after the call.
**kind** `string`
imaging: every satellite below geosynchronous orbit in the catalogues read that carries an imager; all: those plus the altimetry, GNSS and ionosphere missions listed beside them. One of `imaging`, `all`. Defaults to `"imaging"`.
**min\_elevation\_deg** `number`
Elevation above the horizon at the point that defines rise and set. From 0 to 90. Defaults to `10`.
**limit** `integer`
Most passes to return. From 1 to 200. Defaults to `25`.
## Response (200 OK)
Top-level envelope: `success` (boolean) and `data` (object). All fields below are nested under `data`.
**data.request\_id** `string`
Durable job ID for audit and lookup
**data.status** `string`
Job status: `completed`
**data.tool** `string`
Always `place_satellite_passes`
**data.result** `object`
The answer, described under Result below
**data.evidence** `object`
Where the answer came from and when
**data.evidence.source** `string`
The public body the data comes from. Always `CelesTrak`.
**data.evidence.source\_kind** `string`
`public` when the data comes from a public body, `commercial` otherwise
**data.evidence.retrieved\_at** `string`
When the lookup was made, as an ISO 8601 UTC time
**data.evidence.as\_of** `string | null`
The newest element epoch among the satellites considered, when the source last measured an orbit the answer uses; null when none was listed.
## Result
Nested under `data.result`.
**data.result.coverage** `object`
Coverage.
**data.result.coverage.window\_start** `string`
Start of the window, ISO 8601 UTC.
**data.result.coverage.window\_end** `string`
End of the window, ISO 8601 UTC.
**data.result.coverage.kind** `string`
Kind.
**data.result.coverage.groups** `string[]`
The catalogues read.
**data.result.coverage.satellites** `object[]`
Every satellite whose orbit was propagated over the window.
**data.result.coverage.satellites\[].satellite** `string`
Satellite.
**data.result.coverage.satellites\[].norad\_id** `integer`
Norad id.
**data.result.coverage.satellites\[].epoch** `string`
The element epoch, ISO 8601 UTC: when the orbit was last measured.
**data.result.coverage.satellites\[].sensor** `string | null`
The imaging sensor from the swath table, or null for a satellite whose swath is not tabled.
**data.result.coverage.satellites\[].swath\_km** `number | null`
The sensor swath on the ground, or null when not tabled.
**data.result.coverage.not\_published** `object[]`
Swath-table satellites the source did not list, so their passes are unknown.
**data.result.coverage.not\_published\[].satellite** `string`
Satellite.
**data.result.coverage.not\_published\[].norad\_id** `integer`
Norad id.
**data.result.coverage.too\_far\_from\_epoch** `integer`
Passes left out because they lie more than 3 days from the element epoch.
**data.result.coverage.high\_orbit\_left\_out** `integer`
Satellites in the catalogues read that do not pass over a point (geosynchronous and higher).
**data.result.total** `integer`
Passes in the window, including any beyond limit.
**data.result.returned** `integer`
Returned.
**data.result.truncated** `boolean`
True when passes beyond limit were left out.
**data.result.passes** `object[]`
In time order of rise\_at.
**data.result.passes\[].observed** `object`
What the source published about the satellite: its identity and the orbit the pass is computed from.
**data.result.passes\[].observed.satellite** `string`
The satellite name as the catalogue spells it.
**data.result.passes\[].observed.norad\_id** `integer`
The satellite catalogue number.
**data.result.passes\[].observed.epoch** `string`
The element epoch, ISO 8601 UTC: when the source last measured this orbit.
**data.result.passes\[].observed.mean\_motion\_rev\_per\_day** `number`
Revolutions per day, as the element set states.
**data.result.passes\[].observed.inclination\_deg** `number`
Orbital inclination in degrees, as the element set states.
**data.result.passes\[].derived** `object`
Every value OneShot computes from the published orbit; each names its rule and the fields it reads.
**data.result.passes\[].derived.rise\_at** `object`
When the satellite rose above min\_elevation\_deg at the point, ISO 8601 UTC, computed by SGP4; from when the pass was in progress at from.
**data.result.passes\[].derived.rise\_at.value** `string`
Value.
**data.result.passes\[].derived.rise\_at.rule** `string`
Rule.
**data.result.passes\[].derived.rise\_at.from** `string[]`
From.
**data.result.passes\[].derived.culminate\_at** `object`
When it was highest in the sky at the point, ISO 8601 UTC, computed by SGP4.
**data.result.passes\[].derived.culminate\_at.value** `string`
Value.
**data.result.passes\[].derived.culminate\_at.rule** `string`
Rule.
**data.result.passes\[].derived.culminate\_at.from** `string[]`
From.
**data.result.passes\[].derived.set\_at** `object`
When it dropped below min\_elevation\_deg, ISO 8601 UTC, computed by SGP4; to when the pass was still in progress at to.
**data.result.passes\[].derived.set\_at.value** `string`
Value.
**data.result.passes\[].derived.set\_at.rule** `string`
Rule.
**data.result.passes\[].derived.set\_at.from** `string[]`
From.
**data.result.passes\[].derived.max\_elevation\_deg** `object`
Elevation above the horizon at culmination, in degrees, computed by SGP4.
**data.result.passes\[].derived.max\_elevation\_deg.value** `number`
Value.
**data.result.passes\[].derived.max\_elevation\_deg.rule** `string`
Rule.
**data.result.passes\[].derived.max\_elevation\_deg.from** `string[]`
From.
**data.result.passes\[].derived.daynight** `object`
day when the Sun was above the horizon at the point at culmination, otherwise night.
**data.result.passes\[].derived.daynight.value** `string`
Value.
**data.result.passes\[].derived.daynight.rule** `string`
Rule.
**data.result.passes\[].derived.daynight.from** `string[]`
From.
**data.result.passes\[].derived.cut\_by\_window** `object`
True when the pass was in progress at from or at to, so rise\_at or set\_at is the window edge.
**data.result.passes\[].derived.cut\_by\_window\.value** `boolean`
Value.
**data.result.passes\[].derived.cut\_by\_window\.rule** `string`
Rule.
**data.result.passes\[].derived.cut\_by\_window\.from** `string[]`
From.
**data.result.passes\[].derived.track\_distance\_km** `object`
The least kilometres from the point to the ground track anywhere in the pass, to 0.1 km; null when the orbit could not be propagated over the pass.
**data.result.passes\[].derived.track\_distance\_km.value** `number | null`
Value. `null` when the source gives no value.
**data.result.passes\[].derived.track\_distance\_km.rule** `string`
Rule.
**data.result.passes\[].derived.track\_distance\_km.from** `string[]`
From.
**data.result.passes\[].derived.in\_swath** `object`
True when the unrounded least track distance is within half the sensor swath, false when outside it, null for a satellite whose swath is not in the sensor table or without a track distance.
**data.result.passes\[].derived.in\_swath.value** `boolean | null`
Value. `null` when the source gives no value.
**data.result.passes\[].derived.in\_swath.rule** `string`
Rule.
**data.result.passes\[].derived.in\_swath.from** `string[]`
From.
```bash cURL theme={null}
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-satellite-passes \
-H "Content-Type: application/json" \
-H "payment-signature: " \
-d '{
"latitude": 34.05,
"longitude": -118.25,
"limit": 2
}'
```
```javascript JavaScript theme={null}
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-satellite-passes", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 34.05,
"longitude": -118.25,
"limit": 2
}),
});
```
```typescript SDK theme={null}
const result = await agent.tool('lookup/place-satellite-passes', {
latitude: 34.05,
longitude: -118.25,
limit: 2
});
console.log(result.result);
console.log(result.evidence);
```
```json Response (200) theme={null}
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_satellite_passes",
"result": {
"coverage": {
"window_start": "2026-10-27T12:00:00.000Z",
"window_end": "2026-10-29T12:00:00.000Z",
"kind": "imaging",
"groups": [
"resource",
"weather",
"sentinel-1"
],
"satellites": [
{
"satellite": "TECHSAT 1B (GO-32)",
"norad_id": 25397,
"epoch": "2026-10-27T23:06:52.684Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "DLR-TUBSAT",
"norad_id": 25757,
"epoch": "2026-10-27T23:23:54.700Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "TERRA",
"norad_id": 25994,
"epoch": "2026-10-27T22:47:34.154Z",
"sensor": "MODIS",
"swath_km": 2330
},
{
"satellite": "MAROC-TUBSAT",
"norad_id": 27004,
"epoch": "2026-10-27T23:30:06.475Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "AQUA",
"norad_id": 27424,
"epoch": "2026-10-27T22:45:17.531Z",
"sensor": "MODIS",
"swath_km": 2330
},
{
"satellite": "DMSP 5D-3 F16 (USA 172)",
"norad_id": 28054,
"epoch": "2026-10-28T00:02:10.992Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SHIYAN-1 (SY-1)",
"norad_id": 28220,
"epoch": "2026-10-27T17:56:29.628Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "AURA",
"norad_id": 28376,
"epoch": "2026-10-27T21:09:14.394Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "IRS-P5 (CARTOSAT-1)",
"norad_id": 28649,
"epoch": "2026-10-27T22:34:17.780Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SINAH 1",
"norad_id": 28893,
"epoch": "2026-10-27T23:17:31.102Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "RESURS-DK 1",
"norad_id": 29228,
"epoch": "2026-10-27T21:12:13.619Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "ARIRANG-2 (KOMPSAT-2)",
"norad_id": 29268,
"epoch": "2026-10-27T23:29:30.740Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "DMSP 5D-3 F17 (USA 191)",
"norad_id": 29522,
"epoch": "2026-10-27T23:09:01.285Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "LAPAN-TUBSAT",
"norad_id": 29709,
"epoch": "2026-10-27T23:20:16.470Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "HAIYANG-1B",
"norad_id": 31113,
"epoch": "2026-10-27T22:07:23.466Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "COSMO-SKYMED 1",
"norad_id": 31598,
"epoch": "2026-10-27T23:37:20.139Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "TERRASAR-X",
"norad_id": 31698,
"epoch": "2026-10-27T12:30:26.251Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "WORLDVIEW-1 (WV-1)",
"norad_id": 32060,
"epoch": "2026-10-27T22:52:57.888Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-3",
"norad_id": 32289,
"epoch": "2026-10-28T00:09:48.588Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "COSMO-SKYMED 2",
"norad_id": 32376,
"epoch": "2026-10-27T22:54:17.193Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "RADARSAT-2",
"norad_id": 32382,
"epoch": "2026-10-27T23:34:49.096Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CARTOSAT-2A",
"norad_id": 32783,
"epoch": "2026-10-27T23:02:32.030Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "FENGYUN 3A",
"norad_id": 32958,
"epoch": "2026-10-27T20:05:34.391Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "HUANJING 1A (HJ-1A)",
"norad_id": 33320,
"epoch": "2026-10-27T22:03:54.807Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "HUANJING 1B (HJ-1B)",
"norad_id": 33321,
"epoch": "2026-10-27T22:48:48.886Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GEOEYE 1",
"norad_id": 33331,
"epoch": "2026-10-27T22:57:07.121Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "THEOS",
"norad_id": 33396,
"epoch": "2026-10-27T23:43:48.698Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "COSMO-SKYMED 3",
"norad_id": 33412,
"epoch": "2026-10-27T21:54:42.736Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-4",
"norad_id": 33446,
"epoch": "2026-10-27T18:57:03.019Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GOSAT (IBUKI)",
"norad_id": 33492,
"epoch": "2026-10-27T21:20:28.615Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "DEIMOS-1",
"norad_id": 35681,
"epoch": "2026-10-27T22:02:46.244Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "DUBAISAT-1",
"norad_id": 35682,
"epoch": "2026-10-27T21:29:26.618Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "OCEANSAT-2",
"norad_id": 35931,
"epoch": "2026-10-27T22:45:35.221Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "WORLDVIEW-2 (WV-2)",
"norad_id": 35946,
"epoch": "2026-10-27T22:22:48.422Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "DMSP 5D-3 F18 (USA 210)",
"norad_id": 35951,
"epoch": "2026-10-27T22:37:18.219Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SMOS",
"norad_id": 36036,
"epoch": "2026-10-27T22:15:07.068Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-7",
"norad_id": 36110,
"epoch": "2026-10-27T15:21:24.497Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "TANDEM-X",
"norad_id": 36605,
"epoch": "2026-10-27T12:30:26.168Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CARTOSAT-2B",
"norad_id": 36795,
"epoch": "2026-10-27T21:44:56.213Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-10",
"norad_id": 36834,
"epoch": "2026-10-27T23:36:00.800Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "FENGYUN 3B",
"norad_id": 37214,
"epoch": "2026-10-27T23:20:35.669Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "COSMO-SKYMED 4",
"norad_id": 37216,
"epoch": "2026-10-27T23:12:30.500Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "RESOURCESAT-2",
"norad_id": 37387,
"epoch": "2026-10-27T21:37:22.005Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "RASAT",
"norad_id": 37791,
"epoch": "2026-10-27T22:42:29.827Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SUOMI NPP",
"norad_id": 37849,
"epoch": "2026-10-27T23:51:40.517Z",
"sensor": "VIIRS",
"swath_km": 3000
},
{
"satellite": "PLEIADES 1A",
"norad_id": 38012,
"epoch": "2026-10-27T23:02:02.406Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "ZIYUAN 1-02C (ZY 1-02C)",
"norad_id": 38038,
"epoch": "2026-10-27T23:21:41.653Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "ARIRANG-3 (KOMPSAT-3)",
"norad_id": 38338,
"epoch": "2026-10-27T22:05:24.879Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SPOT 6",
"norad_id": 38755,
"epoch": "2026-10-27T22:37:38.570Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "METOP-B",
"norad_id": 38771,
"epoch": "2026-10-27T22:41:49.063Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "PLEIADES 1B",
"norad_id": 39019,
"epoch": "2026-10-27T23:03:25.128Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GOKTURK 2",
"norad_id": 39030,
"epoch": "2026-10-27T23:44:58.919Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "LANDSAT 8",
"norad_id": 39084,
"epoch": "2026-10-27T21:37:16.430Z",
"sensor": "Landsat OLI",
"swath_km": 185
},
{
"satellite": "GAOFEN-1",
"norad_id": 39150,
"epoch": "2026-10-27T22:54:52.497Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "VNREDSAT 1",
"norad_id": 39160,
"epoch": "2026-10-27T22:50:43.029Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "ARIRANG-5 (KOMPSAT-5)",
"norad_id": 39227,
"epoch": "2026-10-27T23:36:13.726Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "FENGYUN 3C",
"norad_id": 39260,
"epoch": "2026-10-27T21:48:54.880Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-A",
"norad_id": 39418,
"epoch": "2026-10-27T16:51:10.384Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "DUBAISAT-2",
"norad_id": 39419,
"epoch": "2026-10-27T22:48:28.067Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GPM-CORE",
"norad_id": 39574,
"epoch": "2026-10-27T21:54:54.515Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SENTINEL-1A",
"norad_id": 39634,
"epoch": "2026-10-27T22:51:48.225Z",
"sensor": "Sentinel-1 IW",
"swath_km": 250
},
{
"satellite": "KAZEOSAT 1",
"norad_id": 39731,
"epoch": "2026-10-27T23:09:04.853Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "ALOS-2",
"norad_id": 39766,
"epoch": "2026-10-27T21:39:30.122Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "KAZEOSAT 2",
"norad_id": 40010,
"epoch": "2026-10-27T22:10:30.086Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "HODOYOSHI-4",
"norad_id": 40011,
"epoch": "2026-10-27T22:56:16.024Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "DEIMOS-2",
"norad_id": 40013,
"epoch": "2026-10-27T22:34:32.348Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "HODOYOSHI-3",
"norad_id": 40015,
"epoch": "2026-10-27T22:45:37.521Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SPOT 7",
"norad_id": 40053,
"epoch": "2026-10-27T21:49:02.541Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "METEOR-M 2",
"norad_id": 40069,
"epoch": "2026-10-27T21:35:34.836Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-B",
"norad_id": 40072,
"epoch": "2026-10-27T22:03:15.656Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "WORLDVIEW-3 (WV-3)",
"norad_id": 40115,
"epoch": "2026-10-27T23:11:07.749Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-2",
"norad_id": 40118,
"epoch": "2026-10-27T22:33:47.675Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-21",
"norad_id": 40143,
"epoch": "2026-10-27T23:32:45.560Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-22",
"norad_id": 40275,
"epoch": "2026-10-27T15:59:32.857Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "ASNARO",
"norad_id": 40298,
"epoch": "2026-10-27T21:53:07.849Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-24",
"norad_id": 40310,
"epoch": "2026-10-27T22:33:33.871Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CBERS 4",
"norad_id": 40336,
"epoch": "2026-10-27T22:59:32.392Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-26",
"norad_id": 40362,
"epoch": "2026-10-27T22:33:59.518Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SMAP",
"norad_id": 40376,
"epoch": "2026-10-27T22:25:33.899Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "KOMPSAT-3A",
"norad_id": 40536,
"epoch": "2026-10-27T23:42:21.445Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SENTINEL-2A",
"norad_id": 40697,
"epoch": "2026-10-27T22:36:15.895Z",
"sensor": "Sentinel-2 MSI",
"swath_km": 290
},
{
"satellite": "GAOFEN-8",
"norad_id": 40701,
"epoch": "2026-10-27T23:19:42.103Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CARBONITE 1 (CBNT-1)",
"norad_id": 40718,
"epoch": "2026-10-27T23:12:51.354Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-27",
"norad_id": 40878,
"epoch": "2026-10-27T23:43:31.112Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-9 01",
"norad_id": 40894,
"epoch": "2026-10-27T23:37:26.194Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-28",
"norad_id": 41026,
"epoch": "2026-10-27T23:36:32.249Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "YAOGAN-29",
"norad_id": 41038,
"epoch": "2026-10-27T22:49:31.529Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "KENT RIDGE 1",
"norad_id": 41167,
"epoch": "2026-10-27T19:22:43.692Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SENTINEL-3A",
"norad_id": 41335,
"epoch": "2026-10-27T21:39:12.358Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SENTINEL-1B",
"norad_id": 41456,
"epoch": "2026-10-27T22:17:54.437Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "ZIYUAN 3-02 (ZY 3-02)",
"norad_id": 41556,
"epoch": "2026-10-27T23:41:44.282Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CARTOSAT-2C",
"norad_id": 41599,
"epoch": "2026-10-27T21:47:49.420Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C1",
"norad_id": 41601,
"epoch": "2026-10-27T14:45:24.068Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "LAPAN-A3",
"norad_id": 41603,
"epoch": "2026-10-27T23:34:59.829Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-3",
"norad_id": 41727,
"epoch": "2026-10-28T00:17:14.925Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C4",
"norad_id": 41771,
"epoch": "2026-10-27T22:56:28.318Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C5",
"norad_id": 41772,
"epoch": "2026-10-27T19:53:12.264Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C2",
"norad_id": 41773,
"epoch": "2026-10-27T20:16:04.388Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C3",
"norad_id": 41774,
"epoch": "2026-10-27T14:54:53.107Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "ALSAT-1B",
"norad_id": 41785,
"epoch": "2026-10-27T23:14:58.939Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "PATHFINDER 1",
"norad_id": 41787,
"epoch": "2026-10-27T22:31:30.298Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GOKTURK 1A",
"norad_id": 41875,
"epoch": "2026-10-27T22:47:33.946Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "RESOURCESAT-2A",
"norad_id": 41877,
"epoch": "2026-10-27T22:51:46.149Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CARTOSAT-2D",
"norad_id": 41948,
"epoch": "2026-10-27T22:32:28.511Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SENTINEL-2B",
"norad_id": 42063,
"epoch": "2026-10-27T22:26:05.822Z",
"sensor": "Sentinel-2 MSI",
"swath_km": 290
},
{
"satellite": "CARTOSAT-2E",
"norad_id": 42767,
"epoch": "2026-10-27T22:58:48.769Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "FORMOSAT-5",
"norad_id": 42920,
"epoch": "2026-10-27T22:40:13.857Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SENTINEL-5P",
"norad_id": 42969,
"epoch": "2026-10-27T20:32:56.835Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C11",
"norad_id": 42987,
"epoch": "2026-10-26T22:41:14.817Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C10",
"norad_id": 42988,
"epoch": "2026-10-27T22:55:53.187Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C9",
"norad_id": 42989,
"epoch": "2026-10-27T22:05:35.848Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C8",
"norad_id": 42990,
"epoch": "2026-10-27T23:26:01.801Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C7",
"norad_id": 42991,
"epoch": "2026-10-27T21:49:43.137Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SKYSAT-C6",
"norad_id": 42992,
"epoch": "2026-10-27T22:39:08.484Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "FENGYUN 3D",
"norad_id": 43010,
"epoch": "2026-10-27T22:05:53.678Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "NOAA 20 (JPSS-1)",
"norad_id": 43013,
"epoch": "2026-10-27T22:30:11.856Z",
"sensor": "VIIRS",
"swath_km": 3000
},
{
"satellite": "CARTOSAT-2F",
"norad_id": 43111,
"epoch": "2026-10-27T23:48:01.529Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-1 02",
"norad_id": 43259,
"epoch": "2026-10-27T22:12:54.113Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-1 03",
"norad_id": 43260,
"epoch": "2026-10-27T23:18:52.218Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-1 04",
"norad_id": 43262,
"epoch": "2026-10-27T22:44:00.360Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SENTINEL-3B",
"norad_id": 43437,
"epoch": "2026-10-27T19:19:31.503Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-5 01",
"norad_id": 43461,
"epoch": "2026-10-27T21:21:05.715Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-6",
"norad_id": 43484,
"epoch": "2026-10-27T23:19:11.063Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-11 01",
"norad_id": 43585,
"epoch": "2026-10-27T22:39:00.508Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "METOP-C",
"norad_id": 43689,
"epoch": "2026-10-27T21:21:46.633Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "HYSIS",
"norad_id": 43719,
"epoch": "2026-10-27T23:32:04.991Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "KAZSTSAT",
"norad_id": 43783,
"epoch": "2026-10-27T20:20:12.088Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SAUDISAT 5A",
"norad_id": 43831,
"epoch": "2026-10-27T22:01:55.197Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SAUDISAT 5B",
"norad_id": 43833,
"epoch": "2026-10-27T23:34:51.380Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "METEOR-M2 2",
"norad_id": 44387,
"epoch": "2026-10-27T22:31:06.106Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-10R",
"norad_id": 44622,
"epoch": "2026-10-27T23:52:17.078Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CARTOSAT-3",
"norad_id": 44804,
"epoch": "2026-10-27T22:31:12.139Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-12 01",
"norad_id": 44819,
"epoch": "2026-10-27T22:53:04.077Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CSG-1",
"norad_id": 44873,
"epoch": "2026-10-27T23:30:47.077Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "NEMO-HD",
"norad_id": 46277,
"epoch": "2026-10-27T23:07:47.277Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "ARKTIKA-M 1",
"norad_id": 47719,
"epoch": "2026-10-27T01:48:51.347Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CAS500-1",
"norad_id": 47932,
"epoch": "2026-10-27T23:06:24.458Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-12 02",
"norad_id": 48079,
"epoch": "2026-10-27T23:29:33.989Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "PLEIADES NEO 3",
"norad_id": 48268,
"epoch": "2026-10-27T22:54:24.494Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "FENGYUN 3E",
"norad_id": 49008,
"epoch": "2026-10-27T23:03:44.584Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "PLEIADES NEO 4",
"norad_id": 49070,
"epoch": "2026-10-27T22:05:46.010Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "LANDSAT 9",
"norad_id": 49260,
"epoch": "2026-10-27T22:26:42.046Z",
"sensor": "Landsat OLI",
"swath_km": 185
},
{
"satellite": "CSG-2",
"norad_id": 51444,
"epoch": "2026-10-27T22:42:06.831Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-12 03",
"norad_id": 52912,
"epoch": "2026-10-27T23:07:55.433Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "NOAA 21 (JPSS-2)",
"norad_id": 54234,
"epoch": "2026-10-27T21:32:53.268Z",
"sensor": "VIIRS",
"swath_km": 3000
},
{
"satellite": "FENGYUN 3G",
"norad_id": 56232,
"epoch": "2026-10-27T20:09:50.978Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "METEOR-M2 3",
"norad_id": 57166,
"epoch": "2026-10-27T23:08:12.827Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "FENGYUN 3F",
"norad_id": 57490,
"epoch": "2026-10-27T22:35:35.226Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GAOFEN-12 04",
"norad_id": 57654,
"epoch": "2026-10-28T00:01:22.480Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "METEOR-M2 4",
"norad_id": 59051,
"epoch": "2026-10-27T22:02:12.615Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "PARS 1",
"norad_id": 59065,
"epoch": "2026-10-27T21:58:55.252Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "RESURS-P 4",
"norad_id": 59371,
"epoch": "2026-10-27T22:43:45.315Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "LEGION 1",
"norad_id": 59625,
"epoch": "2026-10-27T22:28:21.134Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "LEGION 2",
"norad_id": 59626,
"epoch": "2026-10-27T21:38:49.776Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "ALOS-4 (DAICHI-4)",
"norad_id": 60182,
"epoch": "2026-10-27T20:29:59.214Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "LEGION 3",
"norad_id": 60452,
"epoch": "2026-10-27T15:53:46.435Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "LEGION 4",
"norad_id": 60453,
"epoch": "2026-10-27T22:11:36.102Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SENTINEL-2C",
"norad_id": 60989,
"epoch": "2026-10-27T19:55:00.698Z",
"sensor": "Sentinel-2 MSI",
"swath_km": 290
},
{
"satellite": "SENTINEL-1C",
"norad_id": 62261,
"epoch": "2026-10-27T22:55:53.969Z",
"sensor": "Sentinel-1 IW",
"swath_km": 250
},
{
"satellite": "PRSC-EO1",
"norad_id": 62725,
"epoch": "2026-10-27T23:34:03.770Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "BIOMASS",
"norad_id": 63772,
"epoch": "2026-10-27T12:24:46.788Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "GOSAT-GW (IBUKI GW)",
"norad_id": 64694,
"epoch": "2026-10-27T22:32:57.255Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "MICROCARB",
"norad_id": 64899,
"epoch": "2026-10-27T23:11:21.313Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CO3D 3",
"norad_id": 64900,
"epoch": "2026-10-27T22:51:01.569Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CO3D 4",
"norad_id": 64901,
"epoch": "2026-10-27T22:51:23.016Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CO3D 2",
"norad_id": 64902,
"epoch": "2026-10-27T22:03:17.715Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CO3D 1",
"norad_id": 64903,
"epoch": "2026-10-27T22:03:26.112Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "PRSC-S1",
"norad_id": 65055,
"epoch": "2026-10-27T22:49:35.008Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "METOP-SGA1",
"norad_id": 65159,
"epoch": "2026-10-27T22:11:16.253Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "FENGYUN 3H",
"norad_id": 65815,
"epoch": "2026-10-27T19:09:53.363Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "SENTINEL-1D",
"norad_id": 66315,
"epoch": "2026-10-27T22:06:44.601Z",
"sensor": "Sentinel-1 IW",
"swath_km": 250
},
{
"satellite": "CAS500-3",
"norad_id": 66655,
"epoch": "2026-10-27T19:02:03.932Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CSG-3",
"norad_id": 67304,
"epoch": "2026-10-27T12:28:29.233Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "PRSC-E03",
"norad_id": 68835,
"epoch": "2026-10-27T09:10:56.106Z",
"sensor": null,
"swath_km": null
},
{
"satellite": "CAS500-2",
"norad_id": 69013,
"epoch": "2026-10-27T23:05:20.497Z",
"sensor": null,
"swath_km": null
}
],
"not_published": [],
"too_far_from_epoch": 0,
"high_orbit_left_out": 23
},
"total": 1177,
"returned": 2,
"truncated": true,
"passes": [
{
"observed": {
"satellite": "AURA",
"norad_id": 28376,
"epoch": "2026-10-27T21:09:14.394Z",
"mean_motion_rev_per_day": 14.61492977,
"inclination_deg": 98.3601
},
"derived": {
"rise_at": {
"value": "2026-10-27T12:00:00.000Z",
"rule": "sgp4_first_instant_at_or_above_min_elevation_in_window",
"from": [
"observed.norad_id",
"observed.epoch",
"input.latitude",
"input.longitude",
"input.min_elevation_deg",
"input.from"
]
},
"culminate_at": {
"value": "2026-10-27T12:00:00.000Z",
"rule": "sgp4_instant_of_greatest_elevation_in_pass",
"from": [
"observed.norad_id",
"observed.epoch",
"input.latitude",
"input.longitude",
"derived.rise_at",
"derived.set_at"
]
},
"set_at": {
"value": "2026-10-27T12:00:25.000Z",
"rule": "sgp4_last_instant_at_or_above_min_elevation_in_window",
"from": [
"observed.norad_id",
"observed.epoch",
"input.latitude",
"input.longitude",
"input.min_elevation_deg",
"input.to"
]
},
"max_elevation_deg": {
"value": 11.9,
"rule": "sgp4_elevation_at_culmination",
"from": [
"observed.norad_id",
"observed.epoch",
"input.latitude",
"input.longitude",
"derived.culminate_at"
]
},
"daynight": {
"value": "night",
"rule": "sun_above_horizon_at_point_at_culmination",
"from": [
"input.latitude",
"input.longitude",
"derived.culminate_at"
]
},
"cut_by_window": {
"value": true,
"rule": "pass_in_progress_at_window_edge",
"from": [
"derived.rise_at",
"derived.set_at",
"input.from",
"input.to"
]
},
"track_distance_km": {
"value": 1789.7,
"rule": "least_great_circle_km_from_point_to_ground_track_in_pass",
"from": [
"observed.norad_id",
"observed.epoch",
"input.latitude",
"input.longitude",
"derived.rise_at",
"derived.set_at"
]
},
"in_swath": {
"value": null,
"rule": "track_distance_km_within_half_sensor_swath",
"from": [
"derived.track_distance_km",
"observed.norad_id"
]
}
}
},
{
"observed": {
"satellite": "CARBONITE 1 (CBNT-1)",
"norad_id": 40718,
"epoch": "2026-10-27T23:12:51.354Z",
"mean_motion_rev_per_day": 14.83931501,
"inclination_deg": 97.6563
},
"derived": {
"rise_at": {
"value": "2026-10-27T12:00:00.000Z",
"rule": "sgp4_first_instant_at_or_above_min_elevation_in_window",
"from": [
"observed.norad_id",
"observed.epoch",
"input.latitude",
"input.longitude",
"input.min_elevation_deg",
"input.from"
]
},
"culminate_at": {
"value": "2026-10-27T12:02:58.000Z",
"rule": "sgp4_instant_of_greatest_elevation_in_pass",
"from": [
"observed.norad_id",
"observed.epoch",
"input.latitude",
"input.longitude",
"derived.rise_at",
"derived.set_at"
]
},
"set_at": {
"value": "2026-10-27T12:06:49.000Z",
"rule": "sgp4_last_instant_at_or_above_min_elevation_in_window",
"from": [
"observed.norad_id",
"observed.epoch",
"input.latitude",
"input.longitude",
"input.min_elevation_deg",
"input.to"
]
},
"max_elevation_deg": {
"value": 30.8,
"rule": "sgp4_elevation_at_culmination",
"from": [
"observed.norad_id",
"observed.epoch",
"input.latitude",
"input.longitude",
"derived.culminate_at"
]
},
"daynight": {
"value": "night",
"rule": "sun_above_horizon_at_point_at_culmination",
"from": [
"input.latitude",
"input.longitude",
"derived.culminate_at"
]
},
"cut_by_window": {
"value": true,
"rule": "pass_in_progress_at_window_edge",
"from": [
"derived.rise_at",
"derived.set_at",
"input.from",
"input.to"
]
},
"track_distance_km": {
"value": 866.3,
"rule": "least_great_circle_km_from_point_to_ground_track_in_pass",
"from": [
"observed.norad_id",
"observed.epoch",
"input.latitude",
"input.longitude",
"derived.rise_at",
"derived.set_at"
]
},
"in_swath": {
"value": null,
"rule": "track_distance_km_within_half_sensor_swath",
"from": [
"derived.track_distance_km",
"observed.norad_id"
]
}
}
}
]
},
"evidence": {
"source": "CelesTrak",
"source_kind": "public",
"retrieved_at": "2026-10-28T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-28T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-28T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-28T12:00:00.000Z"
}
],
"as_of": "2026-10-28T00:17:14.925Z"
}
}
}
```
> [!NOTE]
>
> See [Pricing](https://docs.oneshotagent.com/pricing.md) for this tool's price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers `200`.
## Notes
* Nothing in a pass is measured. observed is what the source published about the satellite and its orbit; every time and figure under derived is computed from that orbit by SGP4 and carries value, rule and from. Accuracy falls with distance from the element epoch, so a pass more than 3 days from its epoch is left out and counted in coverage.too\_far\_from\_epoch. daynight is day when the Sun is above the horizon at the point at culmination.
* derived.track\_distance\_km is the least distance from the point to the ground track anywhere in the pass as reported, to 0.1 km. derived.in\_swath compares that distance, before rounding, with half the sensor swath from a fixed table: VIIRS (Suomi NPP, NOAA-20, NOAA-21) 3,000 km, MODIS (Terra, Aqua) 2,330 km, Landsat 8 and 9 OLI 185 km, Sentinel-2A, 2B and 2C MSI 290 km, Sentinel-1A, 1C and 1D IW 250 km. It is null for an imaging satellite whose swath is not in the table, such as WorldView-3 or Sentinel-3A: the pass is reported, whether the point was in its swath is not known.
* Reading coverage: coverage.satellites lists each satellite considered with its element epoch and, when tabled, its sensor and swath. Empty passes with satellites listed and too\_far\_from\_epoch zero means the orbits were computed and none rose above min\_elevation\_deg: looked, saw nothing. Empty passes with coverage.satellites empty, or with every pass in too\_far\_from\_epoch, means no evidence either way. coverage.not\_published lists swath-table satellites the source did not list.
* from and to are ISO 8601 UTC (a date alone is midnight UTC), at most 48 hours apart and within 3 days of the call either way; defaults are 24 hours before and after the call. A pass in progress at from or at to is cut at the window edge and marked cut\_by\_window. min\_elevation\_deg defaults to 10. limit defaults to 25, at most 200; total, returned and truncated report the list.
* kind imaging (default) considers every satellite below geosynchronous orbit in the Earth resources and weather catalogues and the Sentinel-1 family, the 12-hour Molniya orbit of ARKTIKA-M included, except the missions that carry no imager (altimeters, GNSS reflectometry and occultation constellations, ionosphere probes, data relays); kind all considers those too. Geosynchronous and higher orbits do not pass over a point and are counted in coverage.high\_orbit\_left\_out. Imaging satellites whose orbits are not published are not in the source.
* Three catalogue reads per call, kept in this process for 2 hours as the source asks and shared by every caller in that time, a fresh call included; evidence.calls carry the time the element sets were fetched.
* Results return inline. The finished job stays available at `/v1/requests/{request_id}`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.