Use this endpoint to retrieve VA transfer beneficiaries created by your business.

-H "x-api-key: your_secret_key"

GET {{host}}/v1/va/transfer/beneficiaries

Query Parameters

Field	Data Type	Required	Description
page	integer	No	Page to retrieve. Defaults to `1`.
limit	integer	No	Number of records per page. Maximum is `100`.
order	enum	No	Sort order. Allowed values: `ASC`, `DESC`.
sort	string	No	Field to sort by. Defaults to `createdAt`.
query	string	No	Search by beneficiary account name.
accountNumber	string	No	Search by account number.
startDate	string	No	Filter by creation start date.
endDate	string	No	Filter by creation end date.

If the API call is successful, Kyshi returns a paginated list.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "page": 1,
    "limit": 100,
    "total": 1,
    "pageCount": 1,
    "hasPreviousPage": false,
    "hasNextPage": false,
    "data": [
      {
        "id": "8495ec4e-ce21-405f-b0cf-982702881f4d",
        "accountName": "FEMI ZACK",
        "accountNumber": "0123456789",
        "bankName": "Access Bank",
        "bankCode": "000014",
        "bvn": "",
        "providerId": "SESSION_123456789",
        "description": "Supplier payout",
        "isActive": true,
        "mode": "live",
        "createdAt": "2026-05-20T10:15:00.000Z",
        "updatedAt": "2026-05-20T10:15:00.000Z"
      }
    ]
  }
}