Get all Currencies (Legacy)

Overview

This service is used to get all the currencies in the system used for payments, along with associated beneficiary country names.

Resource Access

• HTTP Method: GET
• Endpoint: /profile/v2.1/currencies
• 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": 7,
      "currencyName": "AED",
      "countryName": "UAE"
    },
    {
      "id": 17,
      "currencyName": "AUD",
      "countryName": "Australia"
    },
    {
      "id": 40,
      "currencyName": "BDT",
      "countryName": "Bangladesh"
    },
    {
      "id": 21,
      "currencyName": "BGN",
      "countryName": "Bulgaria"
    },
    {
      "id": 10,
      "currencyName": "CAD",
      "countryName": "Canada"
    },
    {
      "id": 22,
      "currencyName": "CNY",
      "countryName": "China"
    }
  ],
  "metadata": {
    "total": 51,
    "currentPage": 1,
    "pageSize": 10
  }
}

Response Fields

Field	Type	Description
success	boolean	Flag indicating success.
data	array	List of supported currency objects.
data[].id	number	Unique ID.
data[].currencyName	string	3-letter ISO 4217 currency code.
data[].countryName	string	Associated country name.
metadata.total	number	Total currencies supported.

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.1/currencies?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.1/currencies"
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.1/currencies';
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 to populate supported payout currency pickers in your user interface.

Interactive API Explorer