---
title: "GET /udl/stage"
method: GET
path: "/udl/stage"
tags: ["Launch"]
---

# GET /udl/stage

`GET /udl/stage`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/udl/stage`
- Auth: none declared

Service operation to dynamically query data by a variety of query parameters not specified in this API documentation. See the queryhelp operation (`/udl/<datatype>/queryhelp`) for more details on valid/required query parameter information.

## Query parameters

- `firstResult` integer
- `maxResults` integer

## Response `200`

OK

- StageAbridged[]
  - `id` string: Unique identifier of the record, auto-generated by the system.
  - `idLaunchVehicle` string, required: Identifier of the launch vehicle record for this stage.
  - `idEngine` string, required: Identifier of the Engine record for this stage.
  - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format.
  - `stageNumber` integer: The stage number of this launch stage.
  - `type` string: Engine cycle type (e.g. Electrostatic Ion, Pressure Fed, Hall, Catalytic Decomposition, etc.).
  - `manufacturerOrgId` string: ID of the organization that manufactures this launch stage.
  - `numEngines` integer: The number of the specified engines on this launch stage.
  - `length` number, double: Stage length in meters.
  - `diameter` number, double: Stage maximum external diameter in meters.
  - `mass` number, double: Stage gross mass in kg.
  - `vernier` string: Engine vernier or additional engine type.
  - `numVernier` integer: Number of vernier or additional engines.
  - `mainEngineThrustSeaLevel` number, double: Thrust of the stage main engine at sea level in kN.
  - `mainEngineThrustVacuum` number, double: Thrust of the stage main engine in a vacuum in kN.
  - `thrustSeaLevel` number, double: Total thrust of the stage at sea level in kN.
  - `thrustVacuum` number, double: Total thrust of the stage in a vacuum in kN.
  - `burnTime` number, double: Total burn time of the stage engines in seconds.
  - `numBurns` integer: Number of burns for the stage engines.
  - `vernierBurnTime` number, double: Total burn time of the vernier or additional stage engines in seconds.
  - `vernierNumBurns` integer: Total number of burns of the vernier or additional stage engines.
  - `vernierThrustSeaLevel` number, double: Total thrust of one of the vernier or additional engines at sea level in kN.
  - `vernierThrustVacuum` number, double: Total thrust of one of the vernier or additional engines in a vacuum in kN.
  - `numStageElements` integer: Number of launch stage elements used in this stage.
  - `reusable` boolean: Boolean indicating if this launch stage is reusable.
  - `restartable` boolean: Boolean indicating if this launch stage can be restarted.
  - `controlThruster1` string: Control thruster 1 type.
  - `numControlThruster1` integer: Number of type control thruster 1.
  - `controlThruster2` string: Control thruster 2 type.
  - `numControlThruster2` integer: Number of type control thruster 2.
  - `photoURLs` string[]: Array of URLs of photos of the stage.
  - `notes` string: Description/notes of the stage.
  - `avionicsNotes` string: Description/notes of the stage avionics.
  - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system.
  - `createdBy` string: Application user who created the row in the database, auto-populated by the system.
  - `source` string, required: Source of the data.
  - `origin` string: Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin.
  - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system.
  - `dataMode` 'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE', required: Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data: REAL: Data collected or produced that pertains to real-world objects, events, and analysis. TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics. EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data. SIMULATED: Synthetic data generated by a model to mimic real-world datasets.

## Other responses

- `400`: Bad Request
- `401`: Invalid/Missing User Credentials
- `403`: User Is Not Authorized
- `405`: Method Not Allowed
- `406`: MediaType Not Accepted by Request Headers
- `429`: Rate of Requests Exceeds Allowed Limit
- `500`: Internal Server Error

## Changes

> 12 revisions in range; 1 could not be searched.

- **2025-05-29** `4e1cbc17e814`: 2 info
  - added the new optional `query` request parameter `firstResult`
  - added the new optional `query` request parameter `maxResults`
- **2025-04-16** `75f764c843a9`: 2 info
  - api operation id `findAll_122` removed and replaced with ``
  - the endpoint scheme security `BasicAuth` was removed from the API

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/stage/get.md)

---

[API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)
