Retrieve a transfer by transfer ID. The backend also supports lookup by transfer code on this route.

-H "x-api-key: your_secret_key"

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

Path Parameters

Field	Data Type	Required	Description
id	string	Yes	Transfer ID or transfer code.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "id": "8f67e4b1-6351-4c95-88f4-6fd0d5c3a40d",
    "code": "TRF_HzmYr2nf1TIdilc",
    "status": "APPROVED",
    "mode": "live",
    "beneficiary": {
      "id": "8495ec4e-ce21-405f-b0cf-982702881f4d",
      "accountName": "FEMI ZACK"
    },
    "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"
  }
}