List All Beneficiaries

Overview

Lists all beneficiary accounts associated with your company profile, returning their operational statuses (approved, pending, rejected), bank metadata, and account identifiers.

HTTP Request

GET /banking/ibans/v2/profile/v2.1/beneficiaries

Authentication

This endpoint requires an active Bearer JWT token in the Authorization header obtained via POST /banking/ibans/v2/users/login:

Authorization: Bearer <your_access_token>

Code Examples

cURL
JavaScript (Axios)
Python (Requests)

curl -X GET "https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/beneficiaries" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_access_token>"

import axios from 'axios';

const response = await axios.get('https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/beneficiaries', {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <your_access_token>'
  }
});

console.log(response.data);

import requests

url = "https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/beneficiaries"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <your_access_token>" 
}

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

Response (200)

{
  "success": true,
  "data": [
    {
      "id": 284,
      "accountNumber": "2000293918130",
      "bankName": "PUNJAB NATIONAL BANK",
      "beneficiaryAddress": "INSTITUTIONAL AREA, PLOT, NO.05 PNB SWIFT CENTRE - FLOOR 1 GURUGRAM - SECTOR 32",
      "beneficiaryCity": "HARYANA",
      "beneficiaryCompanyName": "OLSEN INDUSTRIA E COMERCIO SA",
      "beneficiaryCountryCode": "IN",
      "beneficiaryEntityType": "company",
      "country": "India",
      "reference": "RP-09062022-003",
      "beneficiaryFirstName": "",
      "beneficiaryLastName": "",
      "nationalId": "PUNB0644100",
      "currency": "INR",
      "clientReference": "Test-Bene100",
      "status": "approved"
    },
    {
      "id": 283,
      "accountNumber": "2000293918130",
      "bankName": "PUNJAB NATIONAL BANK",
      "beneficiaryAddress": "INSTITUTIONAL AREA, PLOT, NO.05 PNB SWIFT CENTRE - FLOOR 1 GURUGRAM - SECTOR 32",
      "beneficiaryCity": "HARYANA",
      "beneficiaryCompanyName": "Verto",
      "beneficiaryCountryCode": "IN",
      "beneficiaryEntityType": "company",
      "beneficiaryPostcode": "122001",
      "country": "India",
      "reference": "RP-16062022-001",
      "beneficiaryFirstName": "",
      "beneficiaryLastName": "",
      "nationalId": "PUNB0644100",
      "currency": "INR",
      "clientReference": null,
      "status": "approved"
    },
    {
      "id": 282,
      "accountNumber": "2000293918130",
      "bankName": "PUNJAB NATIONAL BANK",
      "beneficiaryAddress": "INSTITUTIONAL AREA, PLOT, NO.05 PNB SWIFT CENTRE - FLOOR 1 GURUGRAM - SECTOR 32",
      "beneficiaryCity": "HARYANA",
      "beneficiaryCompanyName": "OLSEN INDUSTRIA E COMERCIO SA",
      "beneficiaryCountryCode": "IN",
      "beneficiaryEntityType": "company",
      "beneficiaryEmail": "test_100@gmail.com",
      "country": "India",
      "reference": "RP-09062022-003",
      "beneficiaryFirstName": "",
      "beneficiaryLastName": "",
      "nationalId": "PUNB0644100",
      "currency": "INR",
      "clientReference": "Test-100",
      "status": "approved"
    },
    {
      "id": 278,
      "accountNumber": "8311547163",
      "bankName": "Community Federal Savings Bank",
      "beneficiaryAddress": "89-16 JAMAICA AVENUE",
      "beneficiaryCity": "QUEENS",
      "beneficiaryCompanyName": "OLSEN INDUSTRIA E COMERCIO SA",
      "beneficiaryCountryCode": "US",
      "beneficiaryEntityType": "company",
      "country": "USA",
      "reference": "RP-09062022-004",
      "beneficiaryFirstName": "",
      "beneficiaryLastName": "",
      "nationalId": "CMFGUS33",
      "currency": "USD",
      "clientReference": null,
      "status": "approved"
    },
    {
      "id": 277,
      "accountNumber": "2000293918130",
      "bankName": "PUNJAB NATIONAL BANK",
      "beneficiaryAddress": "INSTITUTIONAL AREA, PLOT, NO.05 PNB SWIFT CENTRE - FLOOR 1 GURUGRAM - SECTOR 32",
      "beneficiaryCity": "HARYANA",
      "beneficiaryCompanyName": "OLSEN INDUSTRIA E COMERCIO SA",
      "beneficiaryCountryCode": "IN",
      "beneficiaryEntityType": "company",
      "country": "India",
      "reference": "RP-09062022-003",
      "beneficiaryFirstName": "",
      "beneficiaryLastName": "",
      "nationalId": "PUNB0644100",
      "currency": "USD",
      "clientReference": null,
      "status": "approved"
    },
    {
      "id": 276,
      "accountNumber": "2000293918130",
      "bankName": "BANCO SAFRA SA",
      "beneficiaryAddress": "LUXEMBOURG",
      "beneficiaryCity": "LUXEMBOURG",
      "beneficiaryCompanyName": "OLSEN INDUSTRIA E COMERCIO SA",
      "beneficiaryCountryCode": "US",
      "beneficiaryEntityType": "company",
      "reference": "RP-09062022-001",
      "beneficiaryFirstName": "",
      "beneficiaryLastName": "",
      "nationalId": "SAFRLULLCCY",
      "currency": "USD",
      "clientReference": null,
      "status": "approved"
    },
    {
      "id": 275,
      "accountNumber": "8311547160",
      "bankName": "Community Federal Savings Bank",
      "beneficiaryAddress": "89-16 JAMAICA AVENUE",
      "beneficiaryCity": "QUEENS",
      "beneficiaryCompanyName": "Test OU",
      "beneficiaryCountryCode": "US",
      "beneficiaryEntityType": "company",
      "beneficiaryPostcode": "11421",
      "reference": "RP-09062022-002",
      "beneficiaryFirstName": "",
      "beneficiaryLastName": "",
      "nationalId": "CMFGUS33",
      "currency": "USD",
      "clientReference": null,
      "status": "approved"
    },
    {
      "id": 272,
      "accountNumber": "123654789",
      "bankName": "PUNJAB NATIONAL BANK",
      "beneficiaryAddress": "INSTITUTIONAL AREA, PLOT, NO.05 PNB SWIFT CENTRE - FLOOR 1 GURUGRAM - SECTOR 32",
      "beneficiaryCity": "HARYANA",
      "beneficiaryCompanyName": "",
      "beneficiaryCountryCode": "IN",
      "beneficiaryEntityType": "individual",
      "beneficiaryPostcode": "122001",
      "beneficiaryEmail": "test@test.com",
      "reference": "RP-06062022-002",
      "beneficiaryFirstName": "final ",
      "beneficiaryLastName": "test",
      "nationalId": "PUNB0644100",
      "currency": "INR",
      "clientReference": null,
      "status": "approved"
    },
    {
      "id": 267,
      "accountNumber": "111111",
      "bankName": "PUNJAB NATIONAL BANK",
      "beneficiaryAddress": "INSTITUTIONAL AREA, PLOT, NO.05 PNB SWIFT CENTRE - FLOOR 1 GURUGRAM - SECTOR 32",
      "beneficiaryCity": "HARYANA",
      "beneficiaryCompanyName": "",
      "beneficiaryCountryCode": "IN",
      "beneficiaryEntityType": "individual",
      "beneficiaryEmail": "test@test.com",
      "reference": "RP-25052022-001",
      "beneficiaryFirstName": "final ",
      "beneficiaryLastName": "test",
      "nationalId": "PUNB0644100",
      "currency": "INR",
      "clientReference": "Testing10",
      "status": "approved"
    },
    {
      "id": 266,
      "accountNumber": "11111",
      "bankName": "PUNJAB NATIONAL BANK",
      "beneficiaryAddress": "INSTITUTIONAL AREA, PLOT, NO.05 PNB SWIFT CENTRE - FLOOR 1 GURUGRAM - SECTOR 32",
      "beneficiaryCity": "HARYANA",
      "beneficiaryCompanyName": "",
      "beneficiaryCountryCode": "IN",
      "beneficiaryEntityType": "individual",
      "beneficiaryEmail": "test@test.com",
      "reference": "RP-23022022-001",
      "beneficiaryFirstName": "final ",
      "beneficiaryLastName": "test",
      "nationalId": "PUNB0644100",
      "currency": "INR",
      "clientReference": "Testing10",
      "status": "approved"
    }
  ],
  "metaData": {
    "total": 35,
    "current_page": "1",
    "page_size": "10"
  }
}

Interactive API Explorer

Test this endpoint live against the Ahrvo gateway and Verto sandbox environments:

Overview​

HTTP Request​

Authentication​

Code Examples​

Response (200)​

Interactive API Explorer​