> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usezentra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Transfer

> GET /api/v1/transfers/{id} - Retrieve a single transfer by id

Fetch the latest status and details for a single transfer using its transfer id.

## Endpoint

```text theme={null}
GET /api/v1/transfers/{id}
```

## Path Parameters

<ParamField path="id" type="string" required>
  The transfer identifier returned when the transfer was created or listed.
</ParamField>

## Response

<ResponseField name="data.id" type="string">
  Internal transfer identifier.
</ResponseField>

<ResponseField name="data.reference" type="string">
  Your business reference for verification, retry, and reconciliation.
</ResponseField>

<ResponseField name="data.amount_minor" type="number">
  Transfer amount in minor units.
</ResponseField>

<ResponseField name="data.currency" type="string">
  Asset or currency code for the transfer.
</ResponseField>

<ResponseField name="data.status" type="string">
  Current transfer status, for example `pending`, `successful`, or `failed`.
</ResponseField>

<ResponseField name="data.bankCode" type="string">
  Destination bank code.
</ResponseField>

<ResponseField name="data.accountNumber" type="string">
  Destination account number.
</ResponseField>

<ResponseField name="data.accountName" type="string">
  Resolved beneficiary account name.
</ResponseField>

<ResponseField name="data.createdAt" type="string">
  ISO 8601 creation timestamp.
</ResponseField>

<ResponseField name="data.completedAt" type="string">
  Completion timestamp when available.
</ResponseField>

## Example Request

```bash theme={null}
curl https://api.usezentra.com/api/v1/transfers/trn_abc123xyz \
  -H "Authorization: Bearer YOUR_SECRET_KEY"
```

## Example Response

```json theme={null}
{
  "status": "success",
  "data": {
    "id": "trn_abc123xyz",
    "reference": "TRF_123456",
    "amount_minor": 50000,
    "currency": "NGN",
    "bankCode": "058",
    "accountNumber": "0123456789",
    "accountName": "JOHN DOE",
    "status": "successful",
    "createdAt": "2024-01-15T10:30:00Z",
    "completedAt": "2024-01-15T10:31:00Z"
  }
}
```

## Common Errors

| Status | Code           | Meaning                                |
| ------ | -------------- | -------------------------------------- |
| `401`  | `unauthorized` | Secret key missing or invalid          |
| `404`  | `not_found`    | No transfer exists for the supplied id |

<Info>
  The reviewed public gateway retrieves transfers by `id`. Keep using the returned `reference` for verification, retry, and external reconciliation workflows.
</Info>

## Next Steps

<CardGroup cols={2}>
  <Card title="List Transfers" icon="list" href="/api-reference/transfers/list">
    Query transfer history and apply filters
  </Card>

  <Card title="Webhook Events" icon="webhook" href="/api-reference/webhooks/events">
    Subscribe to transfer lifecycle updates
  </Card>
</CardGroup>
