Satellite

Get Satellite Ephemeris

Retrieve ephemeris data for all operational Hubble Network satellites.

Required Scope: read-satellites

Overview

This endpoint retrieves satellite ephemeris data for all operational satellites in the Hubble Network assigned to your organization. The response includes TLE (Two-Line Element) orbital data, satellite metadata, and optional orbital parameters compatible with the Hubble Device SDK that allow clients to perform lightweight satellite pass calculations without full TLE propagation.

Use Case

Ephemeris data for satellites with station keeping is projected to be constant over time. The Hubble Device SDK uses parameters returned by this endpoint to derive satellite transmission windows for efficient, local beaconing logic stored on the device itself with minimal CPU overhead.

get/v1/org/{org_id}/satellite/ephemeris

Request

  • Base URL: https://api.hubble.com
  • URL: https://api.hubble.com/v1/org/{org_id}/satellite/ephemeris
  • Auth: HTTP bearer

Path parameters

org_idstring uuid required

The ID for an organization

Your organization ID

Response

Satellite ephemeris data retrieved successfully

Example response

{
  "satellites": [
    {
      "satellite_id": 123,
      "ephemeris": "1 12345U 98067A   24001.50000000  .00001234  00000-0  12345-3 0  9999\n2 12345  51.6400 123.4567 0001234  90.1234 270.1234 15.49012345678901",
      "ephemeris_version": 1,
      "ephemeris_drift_rate": 5,
      "orbital_params": {
        "t0": 1770934465,
        "n0": 0.0001781,
        "ndot": 6.23e-14,
        "raan0": 2.484,
        "raandot": 2.04e-7,
        "aop0": 3.404,
        "aopdot": -5.13e-7,
        "inclination": 97.4,
        "eccentricity": 0.0001
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.