---
title: "List Ships"
method: GET
path: "/my/ships"
tags: ["Fleet"]
---

# List Ships

`GET /my/ships`

Return a paginated list of all of ships under your agent's ownership.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Successfully listed ships.

- object
  - `data` ShipJson[], required — unresolved $ref
  - `meta` MetaJson, required — unresolved $ref

## Changes

> 50 revisions in range; 2 not diffed.

- **2023-06-09** `01114438ccb4` — 2 breaking
  - for the `query` request parameter `limit`, default value `10` was added
  - for the `query` request parameter `page`, default value `1` was added
- **2023-06-09** `735393b679c5` — 2 info
  - api tag `Fleet` added
  - api tag `fleet` removed
- **2023-05-23** `252df2c2fc84` — 1 info
  - endpoint added
- **2023-05-20** `86f8c56c4690` — 2 breaking, 2 info
  - for the `query` request parameter `limit`, default value `10` was removed
  - for the `query` request parameter `page`, default value `1` was removed
  - api tag `fleet` added
  - api tag `Fleet` removed

[Change history](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/changes/my/ships/get.md)

---

[API](https://skmtc.dev/spacetradersapi/apis/spacetraders-api.md) · [All operations](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spacetradersapi/spacetraders-api/revisions/197cf9b9a2b6/schema)