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

# List transfers

> List merchant-initiated transfers

## Overview

Lists all merchant-initiated transfers for the authenticated merchant with optional filtering and pagination.

## Authentication

<ParamField header="X-Api-Key" type="string" required>
  Your merchant API key
</ParamField>

## Query Parameters

<ParamField query="limit" type="integer">
  Number of results per page (default: 20, max: 100)
</ParamField>

<ParamField query="page" type="integer">
  Page number (default: 1)
</ParamField>

<ParamField query="status" type="string">
  Filter by external status

  **Allowed values:** `PROCESSING` | `SETTLED` | `FAILED`
</ParamField>

<ParamField query="currency" type="string">
  Filter by transfer currency

  **Allowed values:** `NGN` | `USD`
</ParamField>

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.daya.co/v1/transfers?limit=20&page=1&status=PROCESSING' \
    --header 'X-Api-Key: YOUR_API_KEY'
  ```
</CodeGroup>

## Response

<ResponseField name="data" type="array" required>
  Array of transfer objects
</ResponseField>

<ResponseField name="page" type="integer" required>
  Current page number
</ResponseField>

<ResponseField name="limit" type="integer" required>
  Results per page
</ResponseField>

<ResponseField name="total" type="integer" required>
  Total number of transfers
</ResponseField>

<ResponseField name="total_pages" type="integer" required>
  Total number of pages
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "850e8400-e29b-41d4-a716-446655440000",
        "reference": "txn_ngn_001",
        "status": "PROCESSING",
        "rail": "NGN_BANK",
        "currency": "NGN",
        "amount": "50000.00",
        "debit_currency": "USD",
        "debit_amount": "33.07",
        "fee": "0.81",
        "rate": {
          "side": "SELL",
          "value": "1550.00",
          "captured_at": "2026-01-05T15:04:05Z"
        },
        "recipient": {
          "id": "750e8400-e29b-41d4-a716-446655440000",
          "type": "BANK_ACCOUNT",
          "bank_account": {
            "account_name": "John Doe",
            "account_number_last4": "7890",
            "bank_code": "044",
            "bank_name": "Access Bank"
          }
        },
        "on_behalf_of": null,
        "created_at": "2026-01-05T15:04:05Z",
        "settled_at": null
      }
    ],
    "page": 1,
    "limit": 20,
    "total": 1,
    "total_pages": 1
  }
  ```
</ResponseExample>