Skip to main content
GET
/
platform
/
admin
/
gas_station_admin
/
{walletTenantId}
/
get_gas_station_wallets
Get gas station wallets
curl --request GET \
  --url https://api.example.com/platform/admin/gas_station_admin/{walletTenantId}/get_gas_station_wallets
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.numium.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Description

Fetches the list of wallets that are designated as gas stations for a wallet tenant, used to provide gas fees for blockchain transactions.

​
Input

  • walletTenantId (long, required) — Route parameter identifying the wallet tenant.
  • Tenant context is automatically resolved from the current authenticated session.

​
Output

Returns a GasStationWalletsClientModel containing:
  • walletTenantId (long) — The queried wallet tenant’s identifier.
  • wallets (array) — List of gas station wallet details including identifiers, addresses, balances, and configuration status.

​
Examples

Request 
GET /api/platform/admin/gasstation/1001/wallets
Response (200 OK) 
{
  "data": {
    "walletTenantId": 1001,
    "wallets": [
      {
        "id": 5001,
        "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
        "balance": "2.5",
        "chainId": 1,
        "chainName": "Ethereum Mainnet",
        "isActive": true,
        "autoRefuelEnabled": true
      },
      {
        "id": 5002,
        "address": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
        "balance": "0.8",
        "chainId": 137,
        "chainName": "Polygon Mainnet",
        "isActive": true,
        "autoRefuelEnabled": false
      }
    ]
  },
  "success": true
}

​
Errors

  • 400 Bad Request: Invalid wallet tenant ID format.
  • 401 Unauthorized: Caller is not authenticated.
  • 403 Forbidden: Caller lacks permission to view gas station wallets.
  • 404 Not Found: Wallet tenant with the specified ID does not exist or tenant context is invalid.
  • 500 Internal Server Error: An unexpected server error occurred or tenant context could not be resolved.

​
Notes

Requires platform administrator privileges. Gas station wallets are used to fund transaction fees for operations performed by the wallet tenant. The tenant context is automatically determined from the authenticated user session.

Path Parameters

​
walletTenantId
integer<int64>
required

Identifier of the wallet tenant whose gas station wallets are requested.

Query Parameters

​
api-version
string | null

Response

Gas station wallets successfully retrieved.

Wrapper for API operation results containing success status, error information, and return value.

​
isSuccess
boolean

True if the operation completed successfully, false otherwise.

Example:

true

​
isFailure
boolean

True if the operation failed, false otherwise.

Example:

false

​
error
object

Error information returned when the operation fails.

Example:
{
  "code": "ValidationError",
  "message": "The request parameters failed validation.",
  "info": [
    "The Name field is required.",
    "The Id field must be greater than 0."
  ]
}
​
value
object

The result value returned when the operation is successful.

Example:
{
  "gasStationWallets": [
    {
      "walletTenantId": 1001,
      "balance": 12.34,
      "name": "Operations Wallet"
    }
  ]
}