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

Autorisations

bearerAuthbearer <JWT>
A token issued by the console.

Paramètres de requête

rocketIdstring<uuid>
Only return launches of this rocket.

Requête

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

Réponses

200

200A list of launches.

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

Réponse

[
  {
    "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"
  }
]