Skip to content
HALOWERK

Weltwerk

satellite position

Resolves the object via CelesTrak GP data (by NORAD catalogue number or an exact object name; ambiguous names return the candidate list), caches the element set for 2.5 hours and propagates it with SGP4 to the requested time (default now, within ±7 days). Returns latitude, longitude, altitude, speed, footprint radius, sunlit flag, element epoch and age, and optionally look angles from an observer. Works for all objects CelesTrak publishes (active satellites, rocket bodies, debris).

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
norad_idintegerNoNORAD catalogue number, e.g. 25544 for the ISS.
namestringNoObject name as listed by CelesTrak, e.g. "HST". Must match exactly one object.
timestringNo
observerobjectNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "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."
    },
    "time": {
      "type": "string",
      "format": "date-time"
    },
    "observer": {
      "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)."
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "norad_id": 20580
}

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 →