GET /v1/connected_banking/beneficiaries
Returns paginated beneficiaries for the merchant.
Query parameters
| Param | Required | Description |
|---|---|---|
sub_merchant_id | yes | Provided by Open |
bank_account_id | no | Filter by merchant's debit account |
open_beneficiary_id | no | Filter by a specific beneficiary |
search | no | Free-text search over vendor_name, bank_account_number, ifsc |
cursor | no | Pagination cursor |
limit | no | Page size, default 25, max 100 |
Success — 200 OK
{
"status": "success",
"data": {
"bene_details": [
{
"bank_account_id": "d88a2124-fdeb-414d-b836-418ee28e31c6",
"open_beneficiary_id": "a54b9250-a3f9-4e46-b585-61317b1d364d",
"bank_beneficiary_id": "a54b9250-a3f9-4e46-b585-61317b1d364d",
"vendor_name": "Aswin Test",
"bank_account_number": "77770112257111",
"ifsc": "FDRL0007777",
"beneficiary_status": "active"
},
{
"bank_account_id": "d88a2124-fdeb-414d-b836-418ee28e31c6",
"open_beneficiary_id": "a859ee9d-9874-4e94-bc2c-2c09e0b53bb7",
"bank_beneficiary_id": "",
"vendor_name": "ICICI OPEN",
"bank_account_number": "000201246539",
"ifsc": "ICIC0000001",
"beneficiary_status": "active"
},
{
"bank_account_id": "d88a2124-fdeb-414d-b836-418ee28e31c6",
"open_beneficiary_id": "9521b073-c47e-4b52-a279-84eaf006b912",
"bank_beneficiary_id": "",
"vendor_name": "AXIS RIB",
"bank_account_number": "123020012256076",
"ifsc": "UTIB0001799",
"beneficiary_status": "verify_started"
}
]
},
"error": null,
"meta": {
"timestamp": "2026-07-23T11:01:12.091817127Z",
"pagination": {
"cursor": null,
"next_cursor": null,
"limit": 25,
"has_more": false
}
}
}Possible errors: OPN_CB_BN_002