Fleet

Refuel Ship

Changed on

Refuel your ship by buying fuel from the local market.

Requires the ship to be docked in a waypoint that has the Marketplace trait, and the market must be selling fuel in order to refuel.

Each fuel bought from the market replenishes 100 units in your ship's fuel.

Ships will always be refuel to their frame's maximum fuel capacity when using this action.

post/my/ships/{shipSymbol}/refuel

Request

  • Base URL
    https://api.spacetraders.io/v2
  • URL
    https://api.spacetraders.io/v2/my/ships/{shipSymbol}/refuel
  • Auth
    HTTP bearer

Path parameters

shipSymbolstring required

The ship symbol.

Request body

unitsinteger

The amount of fuel to fill in the ship's tanks. When not specified, the ship will be refueled to its maximum fuel capacity. If the amount specified is greater than the ship's remaining capacity, the ship will only be refueled to its maximum fuel capacity. The amount specified is not in market units but in ship fuel units.

fromCargoboolean

Wether to use the FUEL thats in your cargo or not. Default: false

Example request

{
  "units": 100
}

Response

Refueled successfully.

Changes