ISS pass predictor (visible overhead times) API

Fetches the live ISS two-line element set (TLE) from Celestrak and propagates the orbit in-process with a self-contained SGP4 propagator to return the next overhead passes for your coordinates: rise time/direction, peak elevation, set time, duration, and a visibility rating. The value-add: turning a raw TLE an LLM cannot propagate into concrete dated viewing times. Answers 'when can I see the ISS', 'next ISS pass over my location', 'ISS overhead times tonight', 'what time does the space station fly over'.

Price$0.01per request

MethodPOST

Route/v1/data/iss-pass

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

dataissinternational-space-stationsatellitetlepass-predictionsgp4astronomy

API URLhttps://x402.hexl.dev/v1/data/iss-pass

Integration docs

Example request

{
  "latitude": 40.7128,
  "longitude": -74.006,
  "hours": 48,
  "minElevation": 10
}

Example response

{
  "latitude": 40.7128,
  "longitude": -74.006,
  "tleEpoch": "2024-12-31T12:00:00.000Z",
  "windowHours": 48,
  "minElevation": 10,
  "passCount": 4,
  "passes": [
    {
      "rise": "2025-01-01T06:42:00.000Z",
      "riseAzimuth": 213,
      "riseDirection": "SW",
      "peak": "2025-01-01T06:47:00.000Z",
      "peakElevation": 34.6,
      "peakDirection": "SE",
      "set": "2025-01-01T06:52:30.000Z",
      "durationSeconds": 630,
      "visibility": "good"
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "latitude": {
      "type": "number",
      "examples": [
        40.7128
      ]
    },
    "longitude": {
      "type": "number",
      "examples": [
        -74.006
      ]
    },
    "from": {
      "type": "string",
      "examples": [
        "2025-01-01T00:00:00Z"
      ]
    },
    "hours": {
      "type": "number",
      "default": 48,
      "examples": [
        48
      ]
    },
    "minElevation": {
      "type": "number",
      "default": 10,
      "examples": [
        10
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}