---
title: "ListGasStations"
method: GET
path: "/v2/vaults/{vault_id}/gasStations"
tags: ["Gas Stations"]
---

# ListGasStations

`GET /v2/vaults/{vault_id}/gasStations`

## Request

- Base URL: `https://api.utila.io`
- URL: `https://api.utila.io/v2/vaults/{vault_id}/gasStations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/utila/apis/utila-api/docs/v2/vaults/:vault_id/gasStations/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of all gas stations in a vault.

## Path parameters

- `vault_id` string, required

## Response `200`

A successful response.

- V2ListGasStationsResponse
  - `gasStations` V2GasStation[]
    - `name` string: The resource name of the gas station. Format: `vaults/{vault_id}/gasStations/{gas_station_id}`
    - `network` string, required: The resource name of the network of the gas station. Format: `networks/{network_id}`
    - `provider` 'TRONEX', required
    - `balance` string: The balance of the gas station.
    - `depositAddresses` V2GasStationDepositAddress[]: The deposit addresses of the gas station.
      - `depositAddressDeprecated` string: The deposit address of the gas station. Deprecated: use `deposit_address` instead.
      - `supportedAssets` string[]: The supported assets of the gas station deposit address. These are the assets that this address accepts.
      - `depositAddress` Apiv2Address
        - `value` string: The actual address.
        - `infoRef` string: If it's an address in the vault (e.g., a wallet address), a reference to address information will be listed here. Address information can be fetched from `ReferencedAddressesInfo` map with the reference as the key. Will be populated only if `includeReferencedResources` is set to `true`.
        - `private` boolean: True when the address is redacted because it belongs to a private Aleo record. When set, `value` is empty.
    - `balanceAsset` string: The balance and alert threshold asset of the gas station.
    - `alertThreshold` integer: The alert threshold of the gas station. This is the amount of the balance asset that will trigger an alert. If not set, there won't be any alert triggered.
  - `referencedResources` object: A mapping of the referenced resources in the message. The key is the resource name and the value is the corresponding resource.
  - `referencedAddressesInfo` object: A mapping of the addresses information in the message. The key is the address information reference and the value is the corresponding address information.

## Changes

- **2026-11-03** `c4a910d79740`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/utila/apis/utila-api/changes/v2/vaults/:vault_id/gasStations/get.md)

---

[API](https://skmtc.dev/utila/apis/utila-api.md) - [All operations](https://skmtc.dev/utila/apis/utila-api/llms.txt) - [OpenAPI document](https://skmtc.dev/utila/apis/utila-api/revisions/c4a910d79740?raw)