Use this endpoint to retrieve a VA beneficiary by beneficiary ID. The backend also supports lookup by account number on this route.

-H "x-api-key: your_secret_key"

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

Path Parameters

Field	Data Type	Required	Description
id	string	Yes	Beneficiary ID. Account number is also supported.

If the API call is successful, Kyshi returns the beneficiary.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "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"
  }
}