Use this endpoint to retrieve VA transfers for your business.

-H "x-api-key: your_secret_key"

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

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`.
status	string	No	Filter by transfer status. Supported values: `PENDING_APPROVAL`, `APPROVED`.
beneficiaryId	string	No	Filter by beneficiary ID.

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

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "page": 1,
    "limit": 100,
    "total": 1,
    "pageCount": 1,
    "hasPreviousPage": false,
    "hasNextPage": false,
    "data": [
      {
        "id": "8f67e4b1-6351-4c95-88f4-6fd0d5c3a40d",
        "code": "TRF_HzmYr2nf1TIdilc",
        "status": "APPROVED",
        "mode": "live",
        "beneficiary": {
          "id": "8495ec4e-ce21-405f-b0cf-982702881f4d",
          "accountName": "FEMI ZACK",
          "accountNumber": "0123456789",
          "bankName": "Access Bank",
          "bankCode": "000014"
        },
        "transaction": {
          "reference": "KYSHI-1778623597453",
          "amount": 2000,
          "currency": "NGN",
          "status": "SUCCESS"
        },
        "createdAt": "2026-05-20T10:20:00.000Z",
        "updatedAt": "2026-05-20T10:20:00.000Z",
        "approvedAt": "2026-05-20T10:20:00.000Z"
      }
    ]
  }
}