Get all Wallets (Legacy)

Overview

This endpoint is used to fetch all the wallets associated with your account. A successful request returns the walletId and currency for all available wallets.

Resource Access

• HTTP Method: GET
• Endpoint: /profile/v2.2/wallets
• Authentication: Bearer token required

Request Headers

Header	Value	Required	Description
Accept	application/json	Yes	Content type for the response
Authorization	Bearer {access_token}	Yes	Bearer token for authentication
x-api-key	string	No	API key for additional authentication

Query Parameters

Parameter	Type	Required	Description
pageSize	integer	No	Number of records per page (default: 10).
page	integer	No	Page number to retrieve (default: 1).

Response

Success Response (200 OK)

{
  "success": true,
  "data": [
    {
      "id": 3491,
      "currency": "AED"
    },
    {
      "id": 3064,
      "currency": "USD"
    },
    {
      "id": 3062,
      "currency": "CAD"
    },
    {
      "id": 3033,
      "currency": "AUD"
    },
    {
      "id": 2809,
      "currency": "GHS"
    }
  ],
  "metadata": {
    "total": 11,
    "currentPage": 1,
    "pageSize": 10
  }
}

Response Fields

Field	Type	Description
success	boolean	Flag indicating success.
data	array	List of wallet objects.
data[].id	number	Unique ID of the wallet.
data[].currency	string	3-letter ISO 4217 currency code of the wallet.
metadata.total	number	Total count of wallets.
metadata.currentPage	number	Current page number.
metadata.pageSize	number	Page size.

Error Responses

• 400 Bad Request: Invalid parameters or malformed request
• 401 Unauthorized: Missing or invalid Bearer authentication token
• 403 Forbidden: Insufficient account permissions
• 404 Not Found: Resource not found
• 500 Internal Server Error: An internal server error occurred

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/profile/v2.2/wallets?pageSize=10&page=1' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Python

import requests

url = "https://gateway.ahrvo.network/banking/ibans/v2/profile/v2.2/wallets"
params = {"pageSize": 10, "page": 1}
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

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

JavaScript (Node.js)

const axios = require('axios');

const url = 'https://gateway.ahrvo.network/banking/ibans/v2/profile/v2.2/wallets';
const headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
};
const params = { pageSize: 10, page: 1 };

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

Usage Notes

• Use the returned wallet id when initiating FX trades or payment requests.

Interactive API Explorer