Skip to content
HALOWERK

Weltwerk

satellite pass

Fetches the element set from CelesTrak (by NORAD number or exact name, cached 2.5 hours), propagates with SGP4 in 20-second steps over the requested window and detects passes whose maximum elevation reaches the requested minimum (default 10°). Each pass reports rise, culmination and set (UTC time, azimuth, elevation), range at culmination, duration, whether the satellite is sunlit while the observer is in darkness (sun below -6°), which marks optically visible passes for bright objects such.

POST https://welt.halowerk.com/v1/satellite-pass

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
latnumberYesObserver latitude in decimal degrees (WGS84).
lonnumberYesObserver longitude in decimal degrees.
alt_mnumberNoObserver altitude above sea level in metres (default 0).
norad_idintegerNoNORAD catalogue number, e.g. 25544 for the ISS.
namestringNoObject name as listed by CelesTrak, e.g. "HST". Must match exactly one object.
hoursintegerNoSearch window from now in hours (default 24).
min_elevation_degnumberNoMinimum culmination elevation to report (default 10).
visible_onlybooleanNoOnly passes that are optically visible (observer dark, satellite sunlit).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "lat",
    "lon"
  ],
  "properties": {
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Observer latitude in decimal degrees (WGS84)."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Observer longitude in decimal degrees."
    },
    "alt_m": {
      "type": "number",
      "minimum": -500,
      "maximum": 9000,
      "description": "Observer altitude above sea level in metres (default 0)."
    },
    "norad_id": {
      "type": "integer",
      "minimum": 1,
      "maximum": 999999,
      "description": "NORAD catalogue number, e.g. 25544 for the ISS."
    },
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "pattern": "^[A-Za-z0-9 ()./+_-]+$",
      "description": "Object name as listed by CelesTrak, e.g. \"HST\". Must match exactly one object."
    },
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 72,
      "description": "Search window from now in hours (default 24)."
    },
    "min_elevation_deg": {
      "type": "number",
      "minimum": 0,
      "maximum": 85,
      "description": "Minimum culmination elevation to report (default 10)."
    },
    "visible_only": {
      "type": "boolean",
      "description": "Only passes that are optically visible (observer dark, satellite sunlit)."
    }
  }
}

Open original schema

Published input example

{
  "lat": 52.21,
  "lon": 7.02,
  "norad_id": 25544,
  "hours": 48
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →