---
title: "GET /rest/payloads"
method: GET
path: "/rest/payloads"
---

# GET /rest/payloads

`GET /rest/payloads`

## Query parameters

- `find` PayloadsFind
  - `apoapsis_km` number, float
  - `customer` string
  - `eccentricity` number, float
  - `epoch` object
  - `inclination_deg` number, float
  - `lifespan_years` number, float
  - `longitude` number, float
  - `manufacturer` string
  - `mean_motion` number, float
  - `nationality` string
  - `norad_id` integer
  - `orbit` string
  - `payload_id` object
  - `payload_type` string
  - `periapsis_km` number, float
  - `period_min` number, float
  - `raan` number, float
  - `reference_system` string
  - `regime` string
  - `reused` boolean
  - `semi_major_axis_km` number, float
- `limit` integer
- `offset` integer
- `order` string
- `sort` string

## Response `200`

- Payload[]
  - `customers` string[]
  - `id` object
  - `manufacturer` string
  - `nationality` string
  - `norad_id` integer[]
  - `orbit_params` PayloadOrbitParams
    - `apoapsis_km` number, float
    - `arg_of_pericenter` number, float
    - `eccentricity` number, float
    - `epoch` object
    - `inclination_deg` number, float
    - `lifespan_years` number, float
    - `longitude` number, float
    - `mean_anomaly` number, float
    - `mean_motion` number, float
    - `periapsis_km` number, float
    - `period_min` number, float
    - `raan` number, float
    - `reference_system` string
    - `regime` string
    - `semi_major_axis_km` number, float
  - `orbit` string
  - `payload_mass_kg` number, float
  - `payload_mass_lbs` number, float
  - `payload_type` string
  - `reused` boolean

## Changes

- **2019-10-22** `56b431e70bf6` — 2 info
  - api tag `Endpoints` removed
  - added the new optional `query` request parameter `find`
- **2019-01-23** `6291469b304a` — 1 warning
  - deleted the `query` request parameter `find`
- **2019-01-21** `23e6c8b6a376` — 1 info
  - api tag `Endpoints` added
- **2019-01-21** `dc4958b948ee` — 1 info
  - api tag `Endpoints` removed
- **2019-01-21** `3187b1d50120` — 1 info
  - api tag `Endpoints` added

[Full history](https://skmtc.dev/spacexland/apis/spacex-rest-api/changes/rest/payloads/get.md)

---

[API](https://skmtc.dev/spacexland/apis/spacex-rest-api.md) · [All operations](https://skmtc.dev/spacexland/apis/spacex-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spacexland/spacex-rest-api/revisions/46a3b0b96b33/schema)