How to get ISS pass times for any location with an API

Updated 2026-10-12

Use when an agent needs when a satellite will pass over a given location.

From an MCP client, add https://tanod.dev/mcp and call satellite_passes; calls are paid per use with x402, no key or signup.

POST a latitude and longitude to /v1/space/passes and get the next ISS passes: start, highest point and end with compass direction and elevation, duration, and whether the pass can be seen with the eye.

When to use it

Use it to answer "when can I see the ISS from here?" for a latitude and longitude, to schedule a photo or a reminder, or to feed a bot or an agent. It also covers the stations and visual groups of CelesTrak and NOAA 15, 18 and 19 by NORAD id.

Request

POST lat and lon to /v1/space/passes. Optional fields: days (1 to 3, default 2), min_elevation (degrees above the horizon, default 10), visible_only (default false), alt_m and norad_id (default 25544, the ISS).

curl, using the free tier
curl -s -X POST https://tanod.dev/v1/space/passes \
  -H 'X-Tanod-Free: 1' -H 'content-type: application/json' \
  -d '{"lat": 52.52, "lon": 13.405}'

Response

Response (example, first pass, trimmed)
{
  "satellite": {"norad_id": 25544, "name": "ISS (ZARYA)"},
  "window": {"from": "2026-10-08T04:11:09Z", "to": "2026-10-10T04:11:09Z", "days": 2},
  "count": 8,
  "passes": [{
    "start": {"time": "2026-10-08T08:20:49Z", "azimuth_deg": 217.9, "compass": "SW", "elevation_deg": 10.0},
    "max":   {"time": "2026-10-08T08:23:54Z", "azimuth_deg": 153.0, "compass": "SSE", "elevation_deg": 32.3},
    "end":   {"time": "2026-10-08T08:26:59Z", "azimuth_deg": 88.2,  "compass": "E",   "elevation_deg": 10.0},
    "duration_s": 371,
    "sunlit_at_max": true,
    "sun_altitude_deg": 23.4,
    "visible": false,
    "visibility": "sky_too_bright"
  }]
}

visible is true when the satellite is sunlit and the sky is dark enough to see it with the eye; other passes carry a reason such as sky_too_bright. At most 40 passes are returned. Another NORAD id outside the supported groups is a 422 unknown_satellite, not charged.

Paying: the 402 flow

Leave out the X-Tanod-Free header (or use up the free calls) and the same request gets HTTP 402 with the price (USD 0.002) and how to pay in the accepts list. An x402 client signs a USDC payment on Base, Polygon, Solana, BNB Chain or Arbitrum and retries; there is no account or API key. The full flow is in Pay-per-call APIs for AI agents with x402.

curl, no free header: the 402
curl -s -i -X POST https://tanod.dev/v1/space/passes \
  -H 'content-type: application/json' \
  -d '{"lat": 52.52, "lon": 13.405}'

Limits and attribution

These are SGP4 predictions, not observations. They are computed from CelesTrak orbital elements that are fetched at most every 2 hours, so a prediction is only as fresh as the last element set. Only derived pass times and angles are returned, never the element sets. Cloud cover is not modelled.

Orbital elements: CelesTrak (celestrak.org). No endorsement by CelesTrak is implied. With a cold orbital-data cache a call can take up to a minute or more; if it is too slow you get a 503 that is not charged, so retry.

Price and free allowance

USD 0.002 per call, paid in USDC on Base, Polygon, Solana, BNB Chain or Arbitrum with x402. 5 free skypeek calls per IP per UTC day with the header X-Tanod-Free: 1. The pool is shared by every skypeek route (METAR, TAF, airports, distance, space weather, aurora, asteroids, sun and moon, satellite passes). MCP tool: satellite_passes at https://tanod.dev/mcp, where the free tier is automatic.

Paying by card instead? The same prediction runs as an Apify actor, Satellite & ISS Pass Predictor (tanod/satellite-iss-pass-predictor), billed through your Apify account at USD 0.01 per prediction; give it a list and collect the results from the run's storage.

All endpoints →

Free widget: show the next visible ISS pass for your town on any website with one image tag: ISS pass widget.

Use it from Claude without writing code: in claude.ai or Claude Desktop, add https://tanod.dev/mcp/sky?via=iss-pass-times-api as a custom connector (steps), then ask in plain words, for example "When will the ISS next pass over London?" The free daily allowance is applied automatically over MCP. Beyond it a call needs an x402 payment, which these clients can make.

Related guides: Hosted aviation and space MCP server, Sunrise, sunset and moon phase API, Space weather, Kp index and aurora forecast API, Near-Earth asteroid close approach API, Pay-per-call APIs for AI agents with x402. Back to tanod.dev or the guide index. Results are automated and heuristic.