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

# GET /rest/ships

`GET /rest/ships`

## Query parameters

- `find` ShipsFind
  - `id` object
  - `name` string
  - `model` string
  - `type` string
  - `role` string
  - `active` boolean
  - `imo` integer
  - `mmsi` integer
  - `abs` integer
  - `class` integer
  - `weight_lbs` integer
  - `weight_kg` integer
  - `year_built` integer
  - `home_port` string
  - `status` string
  - `speed_kn` integer
  - `course_deg` integer
  - `latitude` number, float
  - `longitude` number, float
  - `successful_landings` integer
  - `attempted_landings` integer
  - `mission` string
- `limit` integer
- `offset` integer
- `order` string
- `sort` string

## Response `200`

- Ship[]
  - `abs` integer
  - `active` boolean
  - `attempted_landings` integer
  - `class` integer
  - `course_deg` integer
  - `home_port` string
  - `id` object
  - `image` string
  - `imo` integer
  - `missions` ShipMission[]
    - `flight` string
    - `name` string
  - `mmsi` integer
  - `model` string
  - `name` string
  - `position` ShipLocation
    - `latitude` number, float
    - `longitude` number, float
  - `roles` string[]
  - `speed_kn` number, float
  - `status` string
  - `successful_landings` integer
  - `type` string
  - `url` string
  - `weight_kg` integer
  - `weight_lbs` integer
  - `year_built` integer

---

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