---
name: "getFuelCargo"
type: command
status: ok
groups: ["Vehicle Inventory"]
arma3_since: "0.56"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/getFuelCargo
revid: 379345
updated: 2026-10-30T23:54:10Z
---

# getFuelCargo

*Command · Vehicle Inventory · Arma 3 v0.56*

Locality: arguments **global**

## Description

Returns the fuel amount (1 is full) in the cargo space of a refueling vehicle.

> [!NOTE]
> Since Arma 3 v1.96 the return value for vehicles that are not configured to have ability to refuel other vehicles is -1. (Prior to that the value was negative infinity)

## Syntax

```sqf
getFuelCargo vehicle
```

**Parameters:**

- `vehicle`: [Object](../topics/Object.md)

**Returns:** [Number](../topics/Number.md) - fuel cargo value, -1 if fuel cargo is not supported, 0 if the vehicle is \![alive](../commands/alive.md) or [isNull](../commands/isNull.md)

## Examples

### Example 1

```sqf
value = getFuelCargo myVehicleName;
```

## See also

[setFuelCargo](../commands/setFuelCargo.md) · [getAmmoCargo](../commands/getAmmoCargo.md) · [getRepairCargo](../commands/getRepairCargo.md)

## Community notes

**AgentRev** — 2014-12-22

**Prior to Arma 3 v1.94** If the vehicle is not [alive](../commands/alive.md), it always returns [Nothing](../topics/Nothing.md), which you should check for using [isNil](../commands/isNil.md).\
If the vehicle is unable to carry that type of cargo, it returns [-1.#IND](../topics/Number.md#number-type), which you should check for using [finite](../commands/finite.md) or [<](../commands/a_less_b.md) 0.

---

**Killzone_Kid** — 2019-09-06

If you have ACE mod installed, note that it removes fuel cargo from vehicles so it could appear that the command always returns 0

<sub>Source: [BI Community Wiki — getFuelCargo](https://community.bistudio.com/wiki/getFuelCargo) (revision 379345).</sub>