Skip to content
HALOWERK

Weltwerk

iss position

Fetches the latest two-line element set of the ISS (NORAD 25544) from CelesTrak (cached 2.5 hours per CelesTrak usage rules) and propagates it with SGP4 (satellite.js) to the requested time (default now). Returns geodetic position, altitude, orbital speed, footprint radius, whether the station is sunlit (cylindrical Earth shadow model), the element epoch and its age, optionally a ground track with configurable step for up to 180 minutes ahead, and, if an observer is given, elevation, azimuth.

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
timestringNoUTC time to evaluate (default now; within ±7 days of now).
track_minutesintegerNoLength of the ground track ahead in minutes (default 0 = none).
track_step_minutesintegerNoStep of the ground track in minutes (default 5).
observerobjectNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "time": {
      "type": "string",
      "format": "date-time",
      "description": "UTC time to evaluate (default now; within ±7 days of now)."
    },
    "track_minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 180,
      "description": "Length of the ground track ahead in minutes (default 0 = none)."
    },
    "track_step_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Step of the ground track in minutes (default 5)."
    },
    "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

{
  "track_minutes": 30,
  "observer": {
    "lat": 52.21,
    "lon": 7.02
  }
}

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 →