---
title: "Extract Resources with Survey"
method: POST
path: "/my/ships/{shipSymbol}/extract/survey"
tags: ["Fleet"]
---

# Extract Resources with Survey

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

## Request

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

Use a survey when extracting resources from a waypoint. This endpoint requires a survey as the payload, which allows your ship to extract specific yields.

Send the full survey object as the payload which will be validated according to the signature. If the signature is invalid, or any properties of the survey are changed, the request will fail.

## Path parameters

- `shipSymbol` string, required

## Request body

- SurveyJson (unresolved $ref)

## Response `201`

Extracted successfully.

- object
  - `data` object, required
    - `cooldown` CooldownJson, required (unresolved $ref)
    - `extraction` ExtractionJson, required (unresolved $ref)
    - `cargo` ShipCargoJson, required (unresolved $ref)
    - `events` ShipConditionEventJson[], required (unresolved $ref)

## Changes

> 50 revisions in range; 2 not diffed.

- **2025-02-13** `bc6e0ed16121`: 1 info
  - removed `#/components/schemas/ShipConditionEvent.json` from the `data/events/items/` response property `oneOf` list for the response status `201`
- **2025-02-06** `a4500b4e7ef1`: 1 breaking
  - added the new path request parameter `shipSymbol`
- **2024-03-10** `454e7f036c5f`: 1 info
  - added the required property `data/events` to the response with the `201` status
- **2023-09-13** `5bec99e37d4c`: 1 info
  - endpoint added
- **2023-05-20** `86f8c56c4690`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/changes/my/ships/:shipSymbol/extract/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)