Orbital Telemetry API

Access real-time satellite telemetry, orbital ephemeris data, and telemetry event streams across the Aevum Zenth aerospace constellation. Designed for high-throughput applications requiring sub-second latency and enterprise-grade reliability.

ℹ️ API Version

Currently operating on v1. All endpoints require authentication. Beta features are prefixed with /beta/.

Authentication

All requests must include your API key in the Authorization header. Keys are scoped to specific data partitions and rate limit tiers.

Authorization: Bearer azth_live_8xK2mPqR9vL3nW7yT5jF0bD4cE6gH1iA
Content-Type: application/json
X-AZT-Client: telemetry-dashboard/2.4.1
⚠️ Security Notice

Never expose live keys in client-side code. Use our official SDKs to implement secure key rotation and environment isolation.

Base URL & Versioning

# Production
https://api.aevumzenth.com/orbital-telemetry/v1

# Sandbox (for testing) - rate-limited, simulated data
https://api-sandbox.aevumzenth.com/orbital-telemetry/v1

List Satellites

GET /satellites

Returns a paginated list of all active satellites in the Zenth constellation with metadata, current status, and operational class.

curl -X GET https://api.aevumzenth.com/orbital-telemetry/v1/satellites?page=1&limit=50 \
  -H "Authorization: Bearer $API_KEY"
                                    
import requests

response = requests.get(
    "https://api.aevumzenth.com/orbital-telemetry/v1/satellites",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"page": 1, "limit": 50}
)
data = response.json()
const response = await fetch(
  `https://api.aevumzenth.com/orbital-telemetry/v1/satellites?page=1&limit=50`,
  { headers: { "Authorization": `Bearer ${process.env.API_KEY}` } }
);
const data = await response.json();
200 OK
{
  "data": [
    {
      "id": "AZT-LEO-0892",
      "name": "Meridian-7",
      "constellation": "ZenthMesh-Alpha",
      "status": "nominal",
      "orbit_class": "LEO",
      "last_heartbeat": "2026-03-15T14:22:09Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 142
  }
}

Real-Time Telemetry

GET /satellites/{id}/telemetry

Fetches the latest telemetry snapshot for a specific satellite. Supports polling intervals as low as 500ms on Enterprise tier. Returns telemetry packets with timestamps, signal strength, payload metrics, and thermal readings.

200 OK
{
  "satellite_id": "AZT-LEO-0892",
  "timestamp": "2026-03-15T14:22:09.142Z",
  "telemetry": {
    "signal_strength_dbm": -84.2,
    "cpu_load_pct": 67.8,
    "battery_voltage": 28.4,
    "panel_temp_celsius": -12.5,
    "downlink_throughput_mbps": 1.24,
    "packet_loss_pct": 0.02
  },
  "orbit_position": {
    "lat": 41.8723,
    "lon": -87.6251,
    "altitude_km": 542.1,
    "velocity_kmh": 27600
  }
}

Ephemeris Data

GET /ephemeris/{id}

Returns TLE (Two-Line Element) sets and predicted orbital trajectories for the next 24 hours. Data is updated every 6 hours via ground station uplinks.

200 OK
{
  "satellite_id": "AZT-LEO-0892",
  "tle": {
    "line1": "1 48274U 21084A   26074.59841203  .00002156  00000-0  45678-4 0  9991",
    "line2": "2 48274  53.0192 174.2847 0001245 289.4521  70.5479 15.47629812123456"
  },
  "next_passes": [
    {
      "aos": "2026-03-15T15:42:00Z",
      "los": "2026-03-15T15:48:12Z",
      "max_elevation": 78.4,
      "duration_sec": 372
    }
  ]
}

Event Subscriptions

POST /subscriptions

Register webhook endpoints to receive telemetry anomalies, orbital maneuvers, or scheduled data dumps. Supports retry policies and HMAC signature verification.

POST /subscriptions
{
  "webhook_url": "https://hooks.yourapp.com/azt-telemetry",
  "events": ["anomaly.detected", "orbit.maneuver"],
  "filters": {
    "constellations": ["ZenthMesh-Alpha"],
    "min_severity": "warning"
  }
}

WebSocket Telemetry Stream

For sub-second latency applications, connect to our secure WebSocket endpoint. Authentication is passed via query parameter or initial handshake.

ws://stream.aevumzenth.com/orbital-telemetry/v1?token=YOUR_API_KEY

# Example subscription frame
{
  "type": "subscribe",
  "channels": ["AZT-LEO-0892.telemetry", "AZT-LEO-0892.position"],
  "frequency_ms": 500
}

Rate Limits

Plan Requests / min WebSocket Conn Data Retention
Developer 120 1 24 hours
Professional 1,200 10 30 days
Enterprise Custom Unlimited Full historical
✅ Headers

Rate limit status is returned in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Official SDKs

Language Package Repository
Python pip install azt-telemetry GitHub ↗
JavaScript/TypeScript npm install @aevumzenth/telemetry GitHub ↗
Go go get github.com/aevumzenth/go-telemetry GitHub ↗

© 2026 Aevum Zenth Conglomerate. Orbital Telemetry API v1.2.4

Zenth Tower, Neo Geneva · Documentation License