---
title: "Create Survey"
method: POST
path: "/my/ships/{shipSymbol}/survey"
tags: ["Fleet"]
---

# Create Survey

`POST /my/ships/{shipSymbol}/survey`

Create surveys on a waypoint that can be extracted such as asteroid fields. A survey focuses on specific types of deposits from the extracted location. When ships extract using this survey, they are guaranteed to procure a high amount of one of the goods in the survey.

In order to use a survey, send the entire survey details in the body of the extract request.

Each survey may have multiple deposits, and if a symbol shows up more than once, that indicates a higher chance of extracting that resource.

Your ship will enter a cooldown after surveying in which it is unable to perform certain actions. Surveys will eventually expire after a period of time or will be exhausted after being extracted several times based on the survey's size. Multiple ships can use the same survey for extraction.

A ship must have the `Surveyor` mount installed in order to use this function.

## Path parameters

- `shipSymbol` string, required

## Response `201`

Surveys has been created.

- object
  - `data` object, required
    - `cooldown` CooldownJson, required — unresolved $ref
    - `surveys` SurveyJson[], required — Surveys created by this action. — 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)