---
title: "Ship Refine"
method: POST
path: "/my/ships/{shipSymbol}/refine"
tags: ["Fleet"]
---

# Ship Refine

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

Attempt to refine the raw materials on your ship. The request will only succeed if your ship is capable of refining at the time of the request. In order to be able to refine, a ship must have goods that can be refined and have installed a `Refinery` module that can refine it.

When refining, 100 basic goods will be converted into 10 processed goods.

## Path parameters

- `shipSymbol` string, required

## Request body

- object
  - `produce` 'IRON' | 'COPPER' | 'SILVER' | 'GOLD' | 'ALUMINUM' | 'PLATINUM' | 'URANITE' | 'MERITIUM' | 'FUEL', required — The type of good to produce out of the refining process.

## Response `201`

The ship has successfully refined goods.

- object
  - `data` object, required
    - `cargo` ShipCargoJson, required — unresolved $ref
    - `cooldown` CooldownJson, required — unresolved $ref
    - `produced` object[], required — Goods that were produced by this refining process.
      - `tradeSymbol` string, required — Symbol of the good.
      - `units` integer, required — Amount of units of the good.
    - `consumed` object[], required — Goods that were consumed during this refining process.
      - `tradeSymbol` string, required — Symbol of the good.
      - `units` integer, required — Amount of units of the good.

## Changes

> 50 revisions in range; 2 not diffed.

- **2025-02-06** `a4500b4e7ef1` — 1 breaking
  - added the new path request parameter `shipSymbol`
- **2023-06-24** `5e7680a437df` — 4 info
  - the response property `data/consumed/items/tradeSymbol` became required for the status `201`
  - the response property `data/consumed/items/units` became required for the status `201`
  - the response property `data/produced/items/tradeSymbol` became required for the status `201`
  - the response property `data/produced/items/units` became required for the status `201`
- **2023-06-17** `bb1102e7d71e` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`
- **2023-06-09** `735393b679c5` — 2 info
  - api tag `Fleet` added
  - api tag `fleet` removed
- **2023-05-23** `252df2c2fc84` — 1 info
  - endpoint added

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