> ## 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.

# List Transfers

> GET /api/v1/transfers - Query transfer history

Retrieve transfers for your account with pagination and basic date or status filters.

## Endpoint

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

## Query Parameters

<ParamField query="page" type="number" default="1">
  Page number.
</ParamField>

<ParamField query="limit" type="number" default="20">
  Number of records per page.
</ParamField>

<ParamField query="status" type="string">
  Filter by transfer status.
</ParamField>

<ParamField query="start_date" type="string">
  Start date filter in ISO 8601 format.
</ParamField>

<ParamField query="end_date" type="string">
  End date filter in ISO 8601 format.
</ParamField>

## Example Request

```bash theme={null}
curl "https://api.usezentra.com/api/v1/transfers?page=1&limit=20&status=successful" \
  -H "Authorization: Bearer YOUR_SECRET_KEY"
```

## Example Response

```json theme={null}
{
  "status": "success",
  "data": [
    {
      "id": "txn_abc123",
      "reference": "TXN_123456",
      "amount_minor": 50000,
      "currency": "NGN",
      "bankCode": "058",
      "accountNumber": "0123456789",
      "accountName": "JOHN DOE",
      "status": "successful",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "totalPages": 5
  }
}
```

## Response Notes

* Amounts are returned in minor units.
* Use the transfer `id` for retrieval and the transfer `reference` for verification, retry, and reconciliation flows.
* For near-real-time lifecycle updates, prefer webhooks over polling.

## Next Steps

<CardGroup cols={2}>
  <Card title="Get Transfer" icon="eye" href="/api-reference/transfers/get">
    Fetch one transfer by id
  </Card>

  <Card title="Create Transfer" icon="plus" href="/api-reference/transfers/create">
    Initiate a new transfer
  </Card>
</CardGroup>