curl -X POST https://sim.rotastellar.com/v1/state/batch \
-H "Content-Type: application/json" \
-d '{
"satellites": [
{
"id": "rs-leo-1",
"elements": { "altitude_km": 550, "inclination_deg": 51.6, "raan_deg": 0, "mean_anomaly_deg": 0 }
},
{
"id": "rs-leo-2",
"elements": { "altitude_km": 550, "inclination_deg": 51.6, "raan_deg": 0, "mean_anomaly_deg": 180 }
}
],
"timestamp": "2026-03-08T12:00:00Z"
}'
{
"states": {
"rs-leo-1": {
"lat": 42.15,
"lon": -73.82,
"altitude_km": 550.3,
"velocity_km_s": 7.59,
"in_eclipse": false,
"orbit_fraction": 0.234
},
"rs-leo-2": {
"lat": -38.90,
"lon": 106.18,
"altitude_km": 550.1,
"velocity_km_s": 7.59,
"in_eclipse": true,
"orbit_fraction": 0.734
}
},
"timestamp": "2026-03-08T12:00:00Z",
"count": 2
}
{
"error": "too_many",
"message": "Maximum 100 satellites per batch request"
}
Sim
Batch State
Compute orbital state for up to 100 satellites at once
POST
/
v1
/
state
/
batch
curl -X POST https://sim.rotastellar.com/v1/state/batch \
-H "Content-Type: application/json" \
-d '{
"satellites": [
{
"id": "rs-leo-1",
"elements": { "altitude_km": 550, "inclination_deg": 51.6, "raan_deg": 0, "mean_anomaly_deg": 0 }
},
{
"id": "rs-leo-2",
"elements": { "altitude_km": 550, "inclination_deg": 51.6, "raan_deg": 0, "mean_anomaly_deg": 180 }
}
],
"timestamp": "2026-03-08T12:00:00Z"
}'
{
"states": {
"rs-leo-1": {
"lat": 42.15,
"lon": -73.82,
"altitude_km": 550.3,
"velocity_km_s": 7.59,
"in_eclipse": false,
"orbit_fraction": 0.234
},
"rs-leo-2": {
"lat": -38.90,
"lon": 106.18,
"altitude_km": 550.1,
"velocity_km_s": 7.59,
"in_eclipse": true,
"orbit_fraction": 0.734
}
},
"timestamp": "2026-03-08T12:00:00Z",
"count": 2
}
{
"error": "too_many",
"message": "Maximum 100 satellites per batch request"
}
Base URL:
https://sim.rotastellar.com
ā No API key required.Request
Array of satellite objects, each with
id (string) and elements (orbital elements object). Maximum 100 satellites per request.curl -X POST https://sim.rotastellar.com/v1/state/batch \
-H "Content-Type: application/json" \
-d '{
"satellites": [
{
"id": "rs-leo-1",
"elements": { "altitude_km": 550, "inclination_deg": 51.6, "raan_deg": 0, "mean_anomaly_deg": 0 }
},
{
"id": "rs-leo-2",
"elements": { "altitude_km": 550, "inclination_deg": 51.6, "raan_deg": 0, "mean_anomaly_deg": 180 }
}
],
"timestamp": "2026-03-08T12:00:00Z"
}'
{
"states": {
"rs-leo-1": {
"lat": 42.15,
"lon": -73.82,
"altitude_km": 550.3,
"velocity_km_s": 7.59,
"in_eclipse": false,
"orbit_fraction": 0.234
},
"rs-leo-2": {
"lat": -38.90,
"lon": 106.18,
"altitude_km": 550.1,
"velocity_km_s": 7.59,
"in_eclipse": true,
"orbit_fraction": 0.734
}
},
"timestamp": "2026-03-08T12:00:00Z",
"count": 2
}
{
"error": "too_many",
"message": "Maximum 100 satellites per batch request"
}
Errors
| Status | Code | Description |
|---|---|---|
| 400 | invalid_request | satellites array missing or empty |
| 400 | too_many | More than 100 satellites |
| 400 | invalid_timestamp | Invalid ISO 8601 timestamp |

