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

# Create Survey

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

## Request

- Base URL: `https://api.spacetraders.io/v2`
- URL: `https://api.spacetraders.io/v2/my/ships/{shipSymbol}/survey`
- Auth: HTTP bearer

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)

## Changes

> 50 revisions in range; 2 not diffed.

- **2025-02-06** `a4500b4e7ef1`: 1 breaking
  - added the new path request parameter `shipSymbol`
- **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`: 1 warning, 2 info
  - deleted the `path` request parameter `shipSymbol`
  - api tag `fleet` added
  - api tag `Fleet` removed

[Operation history](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/changes/my/ships/:shipSymbol/survey/post.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.dev/spacetradersapi/apis/spacetraders-api/revisions/197cf9b9a2b6?raw)