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

# GET /ships

`GET /ships`

## Query parameters

- `find` ShipsFind — unresolved $ref
- `id` boolean
- `limit` integer
- `offset` integer
- `order` string
- `sort` string

## Response `200`

- Ship[]
  - `_id` object
  - `ship_id` string
  - `ship_name` string
  - `ship_model` string
  - `ship_type` string
  - `roles` 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` number, float
  - `course_deg` integer
  - `position` ShipLocation
    - `latitude` number, float
    - `longitude` number, float
  - `successful_landings` integer
  - `attempted_landings` integer
  - `missions` ShipMission[]
    - `name` string
    - `flight` string
  - `url` string
  - `image` string

## Changes

- **2019-01-17** `0ce2fdacbf21` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/spacexland/apis/spacex-rest-api/changes/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/0ce2fdacbf21/schema)