Orbit Models API

Overview

The Orgbital7 Orbit Models API provides real-time orbital predictions and trajectory analysis for satellite tracking, collision avoidance, and mission planning. This documentation explains how to access and use our API to get precise orbital data.

Use our API to integrate orbital calculations into your applications for:

• • Mission planning with high-fidelity gravity models
• • Collision prediction with probabilistic analysis
• • Satellite visibility windows and ground station timing
• • Delta-V calculations for maneuvers
• • Geostationary orbital analysis

Need to integrate with legacy systems? Contact our team for on-premise deployment options.

Endpoints

{
  "tles": [
    {
      "satellite": "ISS (ZARYA)",
      "tle": "1 25544U 98067A   25187.37612865 .000167133263513000000002 00000+0 86116-3 0 0 0009",
      "confidence": "high"
    }
  ],
  "start_time": "2025-07-10T14:11:00.000Z",
  "end_time": "2025-07-10T14:15:00.000Z",
  "step": "60"
}
                        

curl 'https://api.orgbital7.io/orbit/predict' \
  -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your_token_here' \
  -d '{
    "tles": [
      {"satellite": "ISS (ZARYA)",
       "tle": "1 25544U 98067A   25187.37612865 .000167133263513000000002 00000+0 86116-3 0 0 0009",
       "confidence": "high"
      },
      {"satellite": "STARLINK-1417",
       "tle": "1 56150U 16090A   25187.37612865 .000167133263513000000002 00000+0 86116-3 0 0 0009",
       "confidence": "medium"
      }
    ],
    "start_time": "2025-07-11T14:11:00.000Z",
    "end_time": "2025-07-11T14:15:00.000Z", 
    "step": "60"
}'
                            

{
  "status": "success",
  "data": [
    {
      "satellite": "ISS (ZARYA)",
      "predictions": [
        {
          "timestamp": "2025-07-10T14:11:00.000Z",
          "position": {
            "x": 6778163.0491,
            "y": -116461.3212,
            "z": 2098148.7740
          },
          "velocity": {
            "x": -7329.8448,
            "y": 7761.1669,
            "z": -2580.6355
          },
          "altitude": 408400.306
        }
      ]
    }
  ]
}

{
  "objects": [
    {
      "id": "SAT-7982",
      "tle": [
        "1 42747U 19052A   25171.083053600.06167 016059.10000+5052.0427-537.000000 530.0623144249998",
        "2 42747 051.4479 031.5087 0003785 033.1080 326.3181 15.03244968260870"
      ]
    },
    {
      "id": "DEB-12398",
      "tle": [
        "1 25541U 98067B   25171.000354900.83222327 00013116 90578 06476355 0421898264",
        "2 25541 26.0269  85.4938 0279973 217.4696 151.9856 14.90200749 00000+00 00000+00"
      ]
    }
  ],
  "start_time": "2025-07-10T14:00:00.000Z",
  "end_time": "2025-07-11T00:00:00.000Z",
  "threshold": 0.1
}

{
  "status": "success",
  "risk_windows": [
    {
      "start": "2025-07-10T23:17:24.337705Z",
      "end": "2025-07-10T23:17:30.337705Z",
      "probability": "0.6699974748%",
      "miss_distance": "46.328872 m"
    }
  ]
}

Authentication

All API requests must include a valid Bearer token in the Authorization header. Tokens are issued through the Orgbital7 Developer Portal.

Authorization: Bearer 
Content-Type: application/json

Token Lifecycle

• Standard access tokens expire in 24 hours
• Rate limits reset every minute
• Renew sessions via /renew-token endpoint

Rate Limiting

Support

Contact our API team with questions: api-support@orgbital7.io