---
title: "Scan Systems"
method: POST
path: "/my/ships/{shipSymbol}/scan/systems"
tags: ["Fleet"]
---

# Scan Systems

`POST /my/ships/{shipSymbol}/scan/systems`

Scan for nearby systems, retrieving information on the systems' distance from the ship and their waypoints. Requires a ship to have the `Sensor Array` mount installed to use.

The ship will enter a cooldown after using this function, during which it cannot execute certain actions.

## Path parameters

- `shipSymbol` string, required

## Response `201`

Successfully scanned for nearby systems.

- object
  - `data` object, required
    - `cooldown` CooldownJson, required — unresolved $ref
    - `systems` ScannedSystemJson[], required — List of scanned systems. — unresolved $ref

---

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