List launches

Launches of a rocket, past and scheduled.

Example page

The Rockets API does not exist: it is described in rockets.yaml to show what OpenAPI pages look like. Launches embed the whole rocket, so this one shows how nested objects are folded away. Below this note, the page is one line of MDX:

<APIPage spec="rockets" path="/launches" method="get" />

GET/launches

Authorizations

bearerAuthbearer <JWT>
A token issued by the console.

Query parameters

rocketIdstring<uuid>
Only return launches of this rocket.

Request

curl -X GET 'https://api.rockets.example/v1/launches' \
  -H 'Authorization: Bearer $TOKEN'

Responses

200

200A list of launches.

idstring<uuid>required
rocketRocketrequired
Show child attributes
- idstring<uuid>required
  Identifier of the rocket.
- namestringrequired
  Display name.
- status"design" | "testing" | "flying" | "retired"required
  Lifecycle of a rocket.
- thrustinteger<int64>
  Thrust at sea level, in kilonewtons.
- stagesStage[]required
  Stages, from the booster upwards.
  Show child attributes
  - namestringrequired
    Name of the stage.
  - enginesinteger<int32>required
    Number of engines on the stage.
  - reusableboolean
    Whether the stage lands back.
- createdAtstring<date-time>
siteobjectrequired
Where the rocket lifts off.
Show child attributes
- namestringrequired
- countrystring
crewstring[]
Names of the crew, empty for an uncrewed flight.
liftoffAtstring<date-time>

Response

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "rocket": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Zenith Heavy",
      "status": "design",
      "thrust": 7600,
      "stages": [
        {
          "name": "Booster",
          "engines": 9,
          "reusable": false
        }
      ],
      "createdAt": "2026-01-01T00:00:00Z"
    },
    "site": {
      "name": "Pad 39A",
      "country": "US"
    },
    "crew": [
      "string"
    ],
    "liftoffAt": "2026-01-01T00:00:00Z"
  }
]