Get specific Wallet Details

Overview

Retrieve detailed balance information, account linkage, and operational flags for a specific wallet by its unique walletId.

Use this endpoint to verify liquid balance before executing an FX conversion or payout, inspect locked amounts, and check whether the wallet is marked as default or disabled.

Resource Access

• HTTP Method: GET
• Endpoint: /banking/ibans/v2/{companyId}/wallets/{walletId}
• Authentication: Bearer token required

Request Headers

Header	Value	Required	Description
Authorization	Bearer {access_token}	Yes	JWT Bearer access token
Accept	application/json	Yes	Response payload format
x-api-key	string	No	Optional API key

Path Parameters

Parameter	Type	Required	Description
companyId	string	Yes	Unique identifier assigned to the company within the system (e.g. 4011).
walletId	number	Yes	Unique identifier assigned to the wallet (e.g. 25427).

Response

Success Response (200 OK)

{
  "id": 25427,
  "totalBalance": 125000.50,
  "availableBalance": 120000.00,
  "currency": "USD",
  "type": "standard",
  "companyId": 4011,
  "customReferenceLabel": "Operating USD Wallet",
  "isDefault": true,
  "isDisabled": false,
  "fundingType": "account"
}

Response Fields

Field	Type	Description
id	number	Unique identifier for the returned wallet.
totalBalance	number	Total cumulative balance including locked funds.
availableBalance	number	Usable balance available for immediate transfers, trades, and withdrawals.
currency	string	ISO currency code (e.g. USD, GBP).
type	string	Type of wallet (standard, fx_balance).
companyId	number	Owner company identifier.
customReferenceLabel	string	User-friendly label.
isDefault	boolean	True if marked as the default wallet for this currency.
isDisabled	boolean	True if disabled for transactions.
fundingType	string	Funding method linkage (account, smartWallet, pooled, null).

Error Responses

• 400 Bad Request: Invalid companyId or walletId format.
• 401 Unauthorized: Missing or expired Bearer token.
• 403 Forbidden: Caller does not have permissions to access this wallet.
• 404 Not Found: Wallet not found for this company.
• 500 Internal Server Error: Internal platform error.

Code Examples

Base URL

Production: https://api.ahrvo.network
Staging:    https://gateway.ahrvo.network

cURL

curl -X GET \
  'https://gateway.ahrvo.network/banking/ibans/v2/4011/wallets/25427' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json'

Python

import requests

company_id = "4011"
wallet_id = 25427
url = f"https://gateway.ahrvo.network/banking/ibans/v2/{company_id}/wallets/{wallet_id}"
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
print(response.status_code, response.json())

JavaScript (Node.js)

const axios = require('axios');

const companyId = '4011';
const walletId = 25427;
const url = `https://gateway.ahrvo.network/${companyId}/wallets/${walletId}`;
const headers = {
  'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
  'Accept': 'application/json'
};

axios.get(url, { headers })
  .then(res => console.log(res.data))
  .catch(err => console.error(err.response ? err.response.data : err.message));

Interactive API Explorer