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

# Extract Resources

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

Extract resources from a waypoint that can be extracted, such as asteroid fields, into your ship. Send an optional survey as the payload to target specific yields.

The ship must be in orbit to be able to extract and must have mining equipments installed that can extract goods, such as the `Gas Siphon` mount for gas-based goods or `Mining Laser` mount for ore-based goods.

The survey property is now deprecated. See the `extract/survey` endpoint for more details.

## Path parameters

- `shipSymbol` string, required

## Request body

- object
  - `survey` 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
    - `modifiers` WaypointModifierJson[] — unresolved $ref
    - `events` ShipConditionEventJson[], required — 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)