-
Notifications
You must be signed in to change notification settings - Fork 12
Launches
shahar603 edited this page May 8, 2022
·
15 revisions
Supply a launch provider using the company (see Company endpoint) parameter and identify the launch using flight_number, mission_id or launch_library_2_id query parameter. You can also omit the company parameter by supplying only the launch_library_2_id query parameter.
http://api.launchdashboard.space/v2/launches/{company}?flight_number={flight_number}http://api.launchdashboard.space/v2/launches/{company}?mission_id={mission_id}http://api.launchdashboard.space/v2/launches/{company}?launch_library_2_id={launch_library_2_id}http://api.launchdashboard.space/v2/launches?launch_library_2_id={launch_library_2_id}
| Param | Sample | Type | Description |
|---|---|---|---|
| company | spacex |
string |
The launch provider's name. Used for identification |
| mission_id | crs-18 |
string |
Identification using the mission name (requires the company parameter) |
| flight_number | 26 |
number |
Identification using the flight number from the launch provider's first flight (requires the company parameter |
| launch_library_2_id | 7e9fd521-c3af-4c55-9873-93bfe9945749 |
number |
Identification using the id used in the launch library API |
| start |
45,maxq
|
number,string
|
Start time/event of the returned telemetry |
| end |
419,meco
|
number,string
|
End time/event of the returned telemetry |
| start_offset |
5,-6
|
number |
Time to add to the start field (or the time at the event) |
| end_offset |
5,-6
|
number |
Time to add to the end field (or the time at the event) |
| event | meco |
string |
Return only the telemetry at the moment of the event |
| event_offset |
3,-2
|
number |
Time to add to the event field |
| frame_rate | `215 | number |
Frequency of the data points in the returned telemetry |
| interval | 2 |
number |
Time between each data points in the returned telemetry |
| stage | 1 |
number |
Return only telemetry from the given stage |
Example 1
Get all available telemetry from SpaceX's 84th flight (AMOS-17)
Query
curl -s http://api.launchdashboard.space/v2/launches/spacex?flight_number=84 | jq
Response
{
"mission_id": "amos-17",
"name": "Amos-17",
"flight_number": 84,
"launch_library_2_id": "eae177d1-3de8-4a21-ad79-fe21afac4f04",
"raw": [
{
"stage": 2,
"telemetry": [
{ "time": 0, "velocity": 0.277, "altitude": 0 },
{ "time": 0.033, "velocity": 0.555, "altitude": 0 },
{ "time": 0.067, "velocity": 0.555, "altitude": 0},
{ "time": 0.1, "velocity": 0.555, "altitude": 0 },
{ "time": 0.133, "velocity": 0.555, "altitude": 0 },
{ "time": 0.166, "velocity": 0.833, "altitude": 0 },
{ "time": 0.2, "velocity": 0.833, "altitude": 0 },
...
{ "time": 1918.333, "velocity": 9518.333, "altitude": 525},
{ "time": 1918.366, "velocity": 9518.333, "altitude": 525}
]
}
],
"analysed": [
{
"stage": 2,
"telemetry": [
{ "time": 0, "velocity": 0.277, "altitude": 0, "velocity_y": -0.219, "velocity_x": 0.168, "acceleration": 10.698 "downrange_distance": 0, "angle": 90, "q": 0.046996480116054146 },
{ "time": 1, "velocity": 1.97, "altitude": 0.001, "velocity_y": 2.039, "velocity_x": -0.038, "acceleration": 11.285, "downrange_distance": 0, "angle": 90, "q": 2.3762015600538513 },
...
{ "time": 506, "velocity": 7424.372, "altitude": 163.85, "velocity_y": -32.707, "velocity_x": 7424.301, "acceleration": -0.016, "downrange_distance": 1585.22, "angle": -0.252, "q": 0 }
]
}
],
"events": [
{ "key": "maxq", "time": 66 },
{ "key": "throttle_down_start", "time": 45 },
{ "key": "throttle_down_end", "time": 91 },
{ "key": "meco", "time": 169 },
...
]
}Example 2
Get the second stage telemetry at 0.5 second intervals from the SpaceX JASON-3 mission from 3 seconds before MECO up to 1 second after SES1 (Second Engine Start 1)
Query
http://api.launchdashboard.space/v2/launches/spacex?mission_id=jason-3&start=meco&start_offset=-3&end=ses1&end_offset=1&interval=0.5&stage=2 | jq
{
"mission_id": "jason-3",
"name": "Jason-3",
"flight_number": 26,
"launch_library_2_id": "de278bee-4f84-4418-a3f3-4d5b969a363f",
"raw": [
{
"stage": 2,
"telemetry": [
{ "time": 152.033, "velocity": 1641.944, "altitude": 63.1 },
{ "time": 152.533, "velocity": 1656.111, "altitude": 63.6 },
{ "time": 153.033, "velocity": 1671.388, "altitude": 64.2},
...
{ "time": 165.566, "velocity": 1647.5, "altitude": 78.7},
{ "time": 166.199, "velocity": 1647.5, "altitude": 79.3 },
{ "time": 166.699, "velocity": 1647.777, "altitude": 79.9 }
]
}
],
"analysed": [
{
"stage": 2,
"telemetry": [
{ "time": 152, "velocity": 1641.944, "altitude": 63.05, "velocity_y": 1158.321, "velocity_x": 1167.458, "acceleration": 35.044, "downrange_distance": 39.826, "angle": 44.823, "q": 0 },
{ "time": 153, "velocity": 1671.388, "altitude": 64.221, "velocity_y": 1170.478, "velocity_x": 1185.725, "acceleration": 34.613, "downrange_distance": 41.002, "angle": 44.634, "q": 0 },
...
{ "time": 166, "velocity": 1647.643, "altitude": 79.085, "velocity_y": 1114.019, "velocity_x": 1225.002, "acceleration": 4.521, "downrange_distance": 56.868, "angle": 42.143, "q": 0 },
{ "time": 167, "velocity": 1648.229, "altitude": 80.25, "velocity_y": 1108.967, "velocity_x": 1227.206, "acceleration": 6.63, "downrange_distance": 58.094, "angle": 41.954, "q": 0 }
]
}
],
"events": [
{ "key": "maxq", "time": 79 },
{ "key": "throttle_down_start", "time": null},
...
]
}Get all available telemetry (webcast, analysed and events) of the latest launch from a launch provider
Given a company_id(see Company endpoint) this endpoint returns all available telemetry of that launch
http://api.launchdashboard.space/v2/launches/latest/{company}
| Param | Sample | Type | Description |
|---|---|---|---|
| company | spacex |
string |
The launch provider's name. Used for identification |
| mission_id | crs-18 |
string |
Identification using the mission name (requires the company parameter) |
| flight_number | 26 |
number |
Identification using the flight number from the launch provider's first flight (requires the company parameter |
| launch_library_2_id | eae177d1-3de8-4a21-ad79-fe21afac4f04 |
number |
Identification using the id used in the launch library API |
| start |
45,maxq
|
number,string
|
Start time/event of the returned telemetry |
| end |
419,meco
|
number,string
|
End time/event of the returned telemetry |
| start_offset |
5,-6
|
number |
Time to add to the start field (or the time at the event) |
| end_offset |
5,-6
|
number |
Time to add to the end field (or the time at the event) |
| event | meco |
string |
Return only the telemetry at the moment of the event |
| event_offset |
3,-2
|
number |
Time to add to the event field |
| frame_rate | `215 | number |
Frequency of the data points in the returned telemetry |
| interval | 2 |
number |
Time between each data points in the returned telemetry |
| stage | 1 |
number |
Return only telemetry from the given stage |
Query
curl -s http://api.launchdashboard.space/v2/launches/latest/spacex | jq
Response
{
"mission_id": "amos-17",
"name": "Amos-17",
"flight_number": 83,
"launch_library_2_id`: "eae177d1-3de8-4a21-ad79-fe21afac4f04",
"raw": [
{
"stage": 2,
"telemetry": [
{ "time": 0, "velocity": 0.277, "altitude": 0 },
{ "time": 0.033, "velocity": 0.555, "altitude": 0 },
{ "time": 0.067, "velocity": 0.555, "altitude": 0},
{ "time": 0.1, "velocity": 0.555, "altitude": 0 },
{ "time": 0.133, "velocity": 0.555, "altitude": 0 },
{ "time": 0.166, "velocity": 0.833, "altitude": 0 },
{ "time": 0.2, "velocity": 0.833, "altitude": 0 },
...
{ "time": 1918.333, "velocity": 9518.333, "altitude": 525},
{ "time": 1918.366, "velocity": 9518.333, "altitude": 525}
]
}
],
"analysed": [
{
"stage": 2,
"telemetry": [
{ "time": 0, "velocity": 0.277, "altitude": 0, "velocity_y": -0.219, "velocity_x": 0.168, "acceleration": 10.698 "downrange_distance": 0, "angle": 90, "q": 0.046996480116054146 },
{ "time": 1, "velocity": 1.97, "altitude": 0.001, "velocity_y": 2.039, "velocity_x": -0.038, "acceleration": 11.285, "downrange_distance": 0, "angle": 90, "q": 2.3762015600538513 },
...
{ "time": 506, "velocity": 7424.372, "altitude": 163.85, "velocity_y": -32.707, "velocity_x": 7424.301, "acceleration": -0.016, "downrange_distance": 1585.22, "angle": -0.252, "q": 0 }
]
}
],
"events": [
{ "key": "maxq", "time": 66 },
{ "key": "throttle_down_start", "time": 45 },
{ "key": "throttle_down_end", "time": 91 },
{ "key": "meco", "time": 169 },
...
]
}Get all available information (that is not telemetry) about a launch or all of the launches by a launch provider
When given just the company query parameter, a list with every launch from the given launch provider are being returned.
When a launch is identified using company and flight_number, mission_id or launch_library_2_id, only the info about that launch is being returned
http://api.launchdashboard.space/v2/launches/info/{company}http://api.launchdashboard.space/v2/launches/info/{company}?flight_number={flight_number}http://api.launchdashboard.space/v2/launches/info/{company}?mission_id={mission_id}http://api.launchdashboard.space/v2/launches/info/{company}?launch_library_2_id={launch_library_2_id}
| Param | Sample | Type | Description |
|---|---|---|---|
| company | spacex |
string |
The launch provider's name. Used for identification |
| mission_id | crs-18 |
string |
Identification using the mission name (requires the company parameter) |
| flight_number | 26 |
number |
Identification using the flight number from the launch provider's first flight (requires the company parameter |
| launch_library_2_id | eae177d1-3de8-4a21-ad79-fe21afac4f04 |
number |
Identification using the id used in the launch library API |
Query
curl -s http://api.launchdashboard.space/v2/launches/info/spacex?flight_number=25
Response
{"mission_id":"orbcomm og2","name":"Orbcomm OG2 Mission 2","flight_number":25,"launch_library_2_id":"7cea85fa-b373-4896-83ae-2629f4030806"}