Skip to content

Launches

shahar603 edited this page Oct 11, 2019 · 15 revisions

Webcast and analysed telemetry of rocket launches from SpaceX and Rocketlab.

Telemetry From a Launch

Get all available telemetry (webcast, analysed and events) of a single launch.

Supply a launch provider using the company (see Company endpoint) parameter and identify the launch using flight_number, mission_name or launch_library_id query parameter. You can also ommit the company parameter by supplying only the launch_library_id query parameter.

See Comapny endpoint to

Query format

  • https://api.launchdashboard.space/v1/launches/{company}?flight_number={flight_number}
  • https://api.launchdashboard.space/v1/launches/{company}?mission_name={mission_name}
  • https://api.launchdashboard.space/v1/launches/{company}?launch_library_id={launch_library_id}
  • https://api.launchdashboard.space/v1/launches?launch_library_id={launch_library_id}

Query Parameters

Param Sample Type Description
company spacex string The launch provider's name. Used for identification
mission_name crs-18 string Identification using the mission name
flight_number 26 number Identification using the flight number from the launch provider's first flight
launch_library_id 1337 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

Example

Query

curl -s https://api.launchdashboard.space/v1/launches/spacex?flight_number=83 | jq

Response

{
  "mission_id": "amos-17",
  "name": "Amos-17",
  "flight_number": 83,
  "launch_library_id": 1388,
  "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 },
    ...
  ]
}

Latest Launch Telemetry

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

Query format

  • https://api.launchdashboard.space/v1/launches/latest/{company}

Example

Query

curl -s https://api.launchdashboard.space/v1/launches/latest/spacex | jq

Response

{
  "mission_id": "amos-17",
  "name": "Amos-17",
  "flight_number": 83,
  "launch_library_id": 1388,
  "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 },
    ...
  ]
}

Info

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_id, only the info about that launch is being returned

Query format

  • https://api.launchdashboard.space/v1/launches/info/{company}
  • https://api.launchdashboard.space/v1/launches/info/{company}?flight_number={flight_number}
  • https://api.launchdashboard.space/v1/launches/info/{company}?mission_name={mission_name}
  • https://api.launchdashboard.space/v1/launches/info/{company}?launch_library_id={launch_library_id}

Example

Query

curl -s https://api.launchdashboard.space/v1/launches/info/spacex?flight_number=25

Response

{"mission_id":"orbcomm og2","name":"Orbcomm OG2 Mission 2","flight_number":25,"launch_library_id":226}
Clone this wiki locally