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.

Authorizations

bearerAuthbearer <JWT>
A token issued by the console.

Query parameters

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.

Request

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

Responses

200

200A page of rockets.

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

Response

{
  "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.

codestringrequired
Machine-readable code.
messagestringrequired
What went wrong.

Response

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