API Reference - Orbital Zoning Framework

API Overview

The Orbital Zoning Framework API provides programmatic access to our comprehensive satellite tracking and orbital zone management system. All endpoints return JSON data and support CORS for web applications.

OZF Operational Modes

The Orbital Zoning Framework supports two modes of orbital classification:

OZF-DYN (Dynamic Zoning): Real-time, continuously updated satellite-to-zone assignments based on TLE ingestion. Ideal for situational awareness and congestion analytics.
OZF-GOV (Governance Zoning): Long-term averaged orbital zones used for stability, licensing, and policy modeling. Updates occur at slower intervals and reference mean orbital parameters. (Under Development)

Many endpoints support the optional system_mode parameter to specify which operational mode to query.

Base URL: https://orbital-governance-mvp-production.up.railway.app

Format: JSON

Authentication: None required (public API)

Core Endpoints

/api/stats

Get system-wide statistics including total zones, satellites, and utilization metrics.

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/stats"

{
  "total_tracts": 13932,
  "active_satellites": 31360,
  "available_tracts": 12293,
  "assigned_satellites": 30729,
  "occupied_zones": 1653,
  "collision_risk_pairs": 0,
  "last_updated": "2026-05-31T15:00:00Z",
  "data_source": "Railway PostgreSQL"
}

/api/satellites

Retrieve live satellite tracking data with orbital parameters and positions.

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/satellites"

[
  {
    "satellite_id": "25544",
    "name": "ISS (ZARYA)",
    "altitude": 425.3,
    "inclination": 51.6,
    "longitude": -45.2,
    "latitude": 12.8,
    "raan": 123.4,
    "eccentricity": 0.000725,
    "usage_type": "Other"
  }
]

Zone Management

/api/zones

List orbital zones with optional region filtering (LEO/MEO) and system mode selection.

Query Parameters:

region (optional): Filter by LEO or MEO
system_mode (optional): dynamic or governance (default: dynamic)
limit (optional): Number of results to return

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/zones?region=LEO&system_mode=dynamic&limit=10"

/api/zones/{zone_id}

Get detailed information about a specific orbital zone including analytics for the specified system mode.

Query Parameters:

system_mode (optional): dynamic or governance (default: dynamic)

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/zones/LEO-A550_600-I50_55-E0?system_mode=dynamic"

/api/zones/{zone_id}/satellites

List all satellites assigned to a specific orbital zone.

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/zones/LEO-A550_600-I50_55-E0/satellites"

/api/tracts/available

Find available orbital zones based on mission parameters.

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/tracts/available?altitude=550&inclination=53&eccentricity=0.0001"

Analytics

/api/analytics/overview

Get comprehensive system analytics including zone utilization, busiest zones, and collision risk assessment for the specified operational mode.

Query Parameters:

system_mode (optional): dynamic or governance (default: dynamic)

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/analytics/overview?system_mode=dynamic"

{
  "utilization": {
    "total_zones": 13932,
    "occupied_zones": 1653,
    "utilization_rate": 11.9,
    "total_assigned_satellites": 30729,
    "unassigned_satellites": 631
  },
  "busiest_zones": [
    {
      "zone_id": "LEO-A450_500-I40_45-E0",
      "zone_name": "LEO Zone | 450–500 km | Inc 40–45° | Ecc 0.0000–0.0005",
      "satellite_count": 3261
    }
  ],
  "metadata": {
    "system_mode": "dynamic",
    "mode_description": "Real-time dynamic zoning with proper elements"
  }
}

OZF SITREP (Orbital Intelligence Reports)

/api/zone-brief

Generate orbital intelligence brief for a single satellite by NORAD ID. Includes local spatial neighbors and regional congestion hotspots for comprehensive situational awareness.

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/zone-brief?norad_id=25544"

{
  "norad_id": 25544,
  "name": "ISS (ZARYA)",
  "object_type": "Other",
  "epoch": "2026-05-30 14:22:00 UTC",
  "region": "LEO",
  "zone_id": "LEO-A400_450-I50_55-E1",
  "altitude_km": 425.3,
  "inclination_deg": 51.6,
  "eccentricity": 0.0007247,
  "eccentricity_class": "Circular",
  "centerline": "425.0 km | 52.5° | Ecc 0.00075",
  "orbital_period": 92.9,
  "congestion_class": "Severe",
  "proper_elements": {
    "a_km": 6795.7036,
    "eccentricity": 0.0008203503,
    "inclination_deg": 51.6337,
    "altitude_km": 417.57,
    "method": "brouwer_j2"
  },
  "secular_rates": {
    "raan_deg_per_day": -4.9519,
    "omega_deg_per_day": 3.6949,
    "raan_period_days": 72.7
  },
  "congestion": {
    "sat_count": 35,
    "percentile": 0.99,
    "neighbor_hotspots": [
      {"zone_id": "LEO-A450_500-I40_45-E0", "sat_count": 3261},
      {"zone_id": "LEO-A450_500-I50_55-E0", "sat_count": 2851}
    ],
    "regional_hotspots": [
      {"zone_id": "LEO-A450_500-I40_45-E0", "sat_count": 3261},
      {"zone_id": "LEO-A450_500-I50_55-E0", "sat_count": 2851}
    ]
  },
  "zone_context": {
    "total_zones": 11664,
    "avg_density": 2.32,
    "high_congestion_zones": 952
  },
  "policy_notes": [
    "Zone density exceeds 90th percentile — collision-avoidance planning advised.",
    "Altitude band lies above significant drag; stable residence time >10 years."
  ],
  "orbital_remarks": [],
  "timestamp": "2026-05-31T15:00:00+00:00"
}

/api/zone-brief (Batch)

Batch processing for multiple satellites with optional CSV export.

POST Request (JSON)

curl -X POST "https://orbital-governance-mvp-production.up.railway.app/api/zone-brief" \
  -H "Content-Type: application/json" \
  -d '{"norad_ids": [25544, 44726, 48060]}'

POST Request (CSV Export)

curl -X POST "https://orbital-governance-mvp-production.up.railway.app/api/zone-brief?format=csv" \
  -H "Content-Type: application/json" \
  -d '{"norad_ids": [25544, 44726]}' \
  -o sitrep_batch.csv

/reports/sitrep/{norad_id}

Generate formatted HTML SITREP report for download or viewing.

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/reports/sitrep/25544"

Report Features: Asset summary, zone assignment details, congestion analysis, zone context, policy notes, orbital remarks, and data confidence disclaimer.

Analytics Endpoints

/api/analytics/overview

Comprehensive system analytics including zone utilization and constellation distribution.

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/analytics/overview"

/api/analytics/region-summary

LEO and MEO region breakdown with utilization statistics.

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/analytics/region-summary"

/api/analytics/density

Orbital density metrics for collision risk assessment.

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/analytics/density"

/api/analytics/usage

Satellite usage distribution by mission type and orbital region.

GET Request

curl -X GET "https://orbital-governance-mvp-production.up.railway.app/api/analytics/usage"

Response Fields Reference

Field	Type	Description
`zone_id`	string	Unique orbital zone identifier (e.g., "LEO-A550_600-I50_55-E0")
`orbit_region`	string	Orbital region classification: "LEO" or "MEO"
`altitude_range`	string	Zone altitude bounds in kilometers (e.g., "550-600 km")
`satellite_id`	string	NORAD catalog number for satellite identification
`usage_type`	string	Mission classification: "Commercial", "Government", "Scientific", "Debris", "Other"
`eccentricity`	number	Orbital eccentricity (0 = circular, 1 = parabolic). Used for zone classification.
`eccentricity_class`	string	Eccentricity classification: "Near-circular", "Circular", "Elliptical", etc.
`proper_elements`	object	Brouwer J2 proper elements: a_km, eccentricity, inclination_deg, method
`secular_rates`	object	RAAN and ω precession rates in °/day, plus RAAN full-cycle period