Taurus LogoTAURUS SPACE
API Reference v1.0

Developer Resources

Integrate real-time space situational awareness directly into your mission control systems. Our API streams sub-second telemetry and AI-driven collision predictions.

Authentication

Authenticate via Bearer Token. Include your unique API key in the header of every request.

bash
Authorization: Bearer YOUR_API_KEY_HERE

Get All Satellites

GET/api/satellites

Returns a paginated list of all satellites from the database, with support for filtering, searching, and sorting.

Parameters

page
integer
Page number. Default: 1.
limit
integer
Results per page. Default: 10.
search
string
Filter by name or NORAD ID.

Example Response

json
{
  "satellites": [
    {
      "norad_id": "25544",
      "name": "INTERNATIONAL SPACE STATION",
      "country": "US"
    }
  ],
  "total": 5231
}

Get Constellation Positions

GET/api/satellites/positions

Retrieves real-time coordinate data for entire constellations, optimized for visualization overlays.

Parameters

constellation
string
Target constellation (e.g., 'starlink', 'oneweb', 'iridium').

Example Response

json
{
  "satellites": [
    {
      "norad_id": 44713,
      "lat": 48.85,
      "lon": 2.35,
      "alt": 550000
    }
  ]
}

Route Optimization

Plan Connectivity

POST/api/flight_plans/plan

Generates a predictive connectivity plan. The engine simulates the vehicle's path against orbital mechanics to identify optimal satellite links.

Parameters

start
object
{ lat, lon } coordinates.
end
object
{ lat, lon } coordinates.
altitude
integer
Meters.

Example Response

json
{
  "segments": [
    {
      "satellite_id": "44713",
      "start": "12:00:00Z",
      "duration": 450
    }
  ]
}

Mission Analysis

Plan Area Coverage

POST/api/mission_plans/plan

Calculates satellite availability for a static geographic Area of Interest (AOI).

Parameters

lat
float
Center latitude.
lon
float
Center longitude.
radius
float
Radius in km.

Example Response

json
{
  "aoi_id": "mission_123",
  "primary": [ { "id": "25544", "name": "ISS" } ]
}

Collisions

Get Conjunctions

GET/api/collisions

Retrieves current conjunction data messages (CDMs).

Example Response

json
[
  {
    "cdm_id": "MOCK-12345678",
    "tca": "2025-09-03 12:45:00",
    "prob": 0.00012
  }
]

Real-Time Streaming

Sub-second updates via WebSocket for live vehicle tracking and spectrum monitoring.

PROTOCOL
WebSocket / Socket.IO
ENDPOINT
wss://api.taurusspace.com

Error Codes

Code
Description
200
Success
401
Unauthorized (Check API Key)
500
Internal Server Error