Skip to main content
GET
/
tenant
/
{tenantId}
/
admin
/
gas_station
/
{walletTenantId}
/
get_wallet_gas_station
GetWalletGasStationConfiguration
curl --request GET \
  --url https://api.example.com/tenant/{tenantId}/admin/gas_station/{walletTenantId}/get_wallet_gas_station
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

​
Description

This endpoint retrieves the complete gas station configuration for a wallet tenant, including auto-refuel settings, custodian information, balance details, and connected wallet counts.

​
Input

  • tenantId (path, required): Identifier of the tenant that owns the wallet
  • walletTenantId (path, required): Identifier of the wallet tenant to query
  • ct (optional): Token to cancel the asynchronous operation

​
Output

Returns a Result<WalletGasStationConfigurationClientModel> containing:
  • Wallet identification and balance information
  • Gas station enabled status and custodian details
  • Auto-refuel configuration (enabled, minimum balance, refuel amount, source wallet)
  • Count of connected wallets depending on this gas station

​
Examples

Request: 
GET /api/tenant/1024/gas-station/wallet/2048/configuration
Response (200 OK): 
{
  "data": {
    "walletTenantId": 2048,
    "walletBalance": 1.25,
    "walletNetwork": "Ethereum Sepolia",
    "walletCoinName": "ETH",
    "walletNetworkIcon": "iVBORw0KGgoAAAA...",
    "walletAddress": "0xABCD...EF01",
    "walletName": "Operations Wallet",
    "walletId": 501,
    "blockchainId": 42,
    "isGasStation": true,
    "gasStationWalletCustodianId": 7,
    "autoRefuelIsEnabled": true,
    "autoRefuelSourceWalletTenantId": 3001,
    "autoRefuelMinimumBalance": 0.1,
    "autoRefuelRefuelAmount": 0.5,
    "connectedGasStationWalletsCount": 3,
    "connectedGasStationWalletsWithNestedCount": 5
  },
  "isSuccess": true
}

​
Errors

  • 400 Bad Request: Invalid wallet or tenant identifier format
  • 401 Unauthorized: Authentication credentials are missing or invalid
  • 403 Forbidden: User lacks permission to view wallet configurations
  • 404 Not Found: Tenant or wallet does not exist
  • 500 Internal Server Error: Unexpected server error occurred during retrieval

​
Notes

  • Returns both direct and nested connection counts for gas station dependency tracking
  • Balance information reflects real-time wallet state
  • Configuration returned includes all settings even if gas station mode is disabled

Path Parameters

​
tenantId
integer<int64>
required

Identifier of the tenant.

​
walletTenantId
integer<int64>
required

Identifier of the tenant wallet.

Query Parameters

​
api-version
string | null

Response

Wallet gas station configuration retrieved successfully.

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:
{
  "walletTenantId": 1001,
  "walletBalance": 12.34,
  "walletNetwork": "Ethereum Sepolia",
  "walletCoinName": "ETH",
  "walletNetworkIcon": "iVBORw0KGgoAAAANSUhEUgAAAAUA",
  "walletAddress": "0xAbCDEF0123456789abcdef0123456789AbCdEf0",
  "walletName": "Treasury Wallet",
  "walletId": 501,
  "blockchainId": 42,
  "isGasStation": true,
  "gasStationWalletCustodianId": 7,
  "autoRefuelIsEnabled": true,
  "autoRefuelSourceWalletTenantId": 2001,
  "autoRefuelMinimumBalance": 0.25,
  "autoRefuelRefuelAmount": 1.5,
  "connectedGasStationWalletsCount": 3,
  "connectedGasStationWalletsWithNestedCount": 5
}