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

​
Description

Retrieves the complete list of custodians that are associated with a particular wallet, providing visibility into which entities can manage or operate the wallet.

​
Input

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

​
Output

Returns a WalletCustodiansClientModel containing:
  • walletId (long) — The queried wallet’s identifier.
  • custodians (array) — List of custodian details including identifiers, names, and relationship metadata.

​
Examples

Request 
GET /api/platform/admin/gasstation/wallet/501/custodians
Response (200 OK) 
{
  "data": {
    "walletId": 501,
    "custodians": [
      {
        "id": 1,
        "name": "Primary Custodian",
        "type": "Institutional",
        "isActive": true
      },
      {
        "id": 2,
        "name": "Secondary Custodian",
        "type": "Individual",
        "isActive": true
      }
    ]
  },
  "success": true
}

​
Errors

  • 400 Bad Request: Invalid wallet ID format.
  • 401 Unauthorized: Caller is not authenticated.
  • 403 Forbidden: Caller lacks permission to view wallet custodians.
  • 404 Not Found: Wallet 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. The tenant context is automatically determined from the authenticated user session. An exception is thrown if no tenant context can be established.

Path Parameters

​
walletId
integer<int64>
required

Identifier of the wallet to inspect.

Query Parameters

​
api-version
string | null

Response

Wallet custodians 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.