List rockets

Page through the rockets of an account.

Example page

The Rockets API does not exist: it is described in rockets.yaml to show what OpenAPI pages look like. This one renders a single operation, with query parameters and a paginated response. Below this note, the page is one line of MDX:

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

GET/rockets

Returns rockets in reverse chronological order, newest first.

Autorisations

bearerAuthbearer <JWT>
A token issued by the console.

Paramètres de requête

status"design" | "testing" | "flying" | "retired"
Only return rockets in this state.
limitinteger<int32>
Number of rockets to return, between 1 and 100.
cursorstring
Cursor returned by a previous call.

Requête

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

Réponses

200

200A page of rockets.

dataRocket[]requis
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>
nextCursorstring | null
Pass it back as `cursor` to fetch the next page.

Réponse

{
  "data": [
    {
      "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"
    }
  ],
  "nextCursor": null
}

401

401The token is missing or invalid.

codestringrequis
Machine-readable code.
messagestringrequis
What went wrong.

Réponse

{
  "code": "not_found",
  "message": "string"
}