---
updatedAt: 2026-09-23T02:21:34.000Z
agentTools:
  projectIndex: https://docs.kyshi.co/llms.txt
---

# Get Transfer

Retrieve one payout transfer.

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

```Text Header
-H "x-api-key: your_secret_key"
```

```Text Request
GET {{host}}/v1/transfer/{id}
```

# Path Parameters

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

```json Response
{
  "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"
  }
}
```