Skip to main content
GET
/
v1
/
transfers
List transfers
curl --request GET \
  --url https://api.daya.co/v1/transfers \
  --header 'X-Api-Key: <x-api-key>'
{
  "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
}

​
Overview

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

​
Authentication

​
X-Api-Key
string
required
Your merchant API key

​
Query Parameters

​
limit
integer
Number of results per page (default: 20, max: 100)
​
page
integer
Page number (default: 1)
​
status
string
Filter by external statusAllowed values: PROCESSING | SETTLED | FAILED
​
currency
string
Filter by transfer currencyAllowed values: NGN | USD

​
Request Example

curl --request GET \
  --url 'https://api.daya.co/v1/transfers?limit=20&page=1&status=PROCESSING' \
  --header 'X-Api-Key: YOUR_API_KEY'

​
Response

​
data
array
required
Array of transfer objects
​
page
integer
required
Current page number
​
limit
integer
required
Results per page
​
total
integer
required
Total number of transfers
​
total_pages
integer
required
Total number of pages
{
  "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
}