---
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

## 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/ships/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)