Skip to main content
GET
/
v1
/
payouts
Legacy: List payouts
curl --request GET \
  --url https://api.daya.co/v1/payouts \
  --header 'X-Api-Key: <x-api-key>'
{
  "data": [
    {
      "type": "NGN_PAYOUT",
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789abc",
      "reference": "PAY-NGN-20250105-001",
      "status": "SETTLED",
      "source_currency": "USD",
      "destination_currency": "NGN",
      "source_amount": "100.00",
      "destination_amount": "155050.00",
      "fee": "1.50",
      "rate": {
        "side": "SELL",
        "value": "1550.50",
        "captured_at": "2025-01-05T15:04:05Z"
      },
      "recipient": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "type": "BANK_ACCOUNT",
        "bank_account": {
          "account_number": "1234567890",
          "account_name": "John Doe",
          "bank_code": "044",
          "bank_name": "Access Bank"
        },
        "crypto_address": null,
        "created_at": "2025-01-05T15:04:05Z"
      },
      "sender": {
        "type": "MERCHANT",
        "id": "c3d4e5f6-a7b8-9012-cdef-345678901abc"
      },
      "tx_hash": null,
      "created_at": "2025-01-05T15:04:05Z",
      "settled_at": "2025-01-05T15:10:00Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 42,
  "total_pages": 3
}

​
Overview

Retrieve a paginated list of read-only settlement payouts.
Payouts are legacy read-only settlement artifacts. Merchant-initiated sends use the Transfers API.

​
Authentication

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

​
Query Parameters

​
type
string
Filter by payout typeAllowed values: CRYPTO_PAYOUT, NGN_PAYOUT
​
status
string
Filter by payout statusAllowed values: PROCESSING, SETTLED, FAILED
​
limit
integer
Results per pageDefault: 20Max: 100
​
page
integer
Page number (1-indexed)Default: 1

​
Request Examples

curl --request GET \
  --url 'https://api.daya.co/v1/payouts' \
  --header 'X-Api-Key: YOUR_API_KEY'

​
Response

​
data
array
required
Array of payout objects
​
page
integer
required
Current page number
​
limit
integer
required
Results per page
​
total
integer
required
Total number of payouts matching filters
​
total_pages
integer
required
Total number of pages

​
Success Response

{
  "data": [
    {
      "type": "NGN_PAYOUT",
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789abc",
      "reference": "PAY-NGN-20250105-001",
      "status": "SETTLED",
      "source_currency": "USD",
      "destination_currency": "NGN",
      "source_amount": "100.00",
      "destination_amount": "155050.00",
      "fee": "1.50",
      "rate": {
        "side": "SELL",
        "value": "1550.50",
        "captured_at": "2025-01-05T15:04:05Z"
      },
      "recipient": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "type": "BANK_ACCOUNT",
        "bank_account": {
          "account_number": "1234567890",
          "account_name": "John Doe",
          "bank_code": "044",
          "bank_name": "Access Bank"
        },
        "crypto_address": null,
        "created_at": "2025-01-05T15:04:05Z"
      },
      "sender": {
        "type": "MERCHANT",
        "id": "c3d4e5f6-a7b8-9012-cdef-345678901abc"
      },
      "tx_hash": null,
      "created_at": "2025-01-05T15:04:05Z",
      "settled_at": "2025-01-05T15:10:00Z"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 42,
  "total_pages": 3
}

​
Next Steps

Get Payout

Get a specific payout by ID

List Deposits

View incoming deposits