---
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

## Changes

> 50 revisions in range; 2 not diffed.

- **2026-07-13** `197cf9b9a2b6` — 1 info
  - added the optional property `data/modifiers` to the response with the `201` status
- **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-02-25** `28a145adc8e9` — 1 info
  - added the required property `data/events` to the response with the `201` status
- **2023-09-13** `5bec99e37d4c` — 1 info
  - request property `survey` deprecated

[Full history](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/changes/my/ships/:shipSymbol/extract/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-service-production.skmtc.workers.dev/v1/apis/spacetradersapi/spacetraders-api/revisions/197cf9b9a2b6/schema)