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

​
Overview

Retrieve a read-only settlement payout by ID.
Payouts are legacy read-only settlement artifacts. Merchant-initiated sends use the Transfers API.

​
Authentication

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

​
Path Parameters

​
id
string
required
Unique payout identifier (UUID)Example: b2c3d4e5-f6a7-8901-bcde-f23456789abc

​
Request Examples

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

​
Response

Same structure as individual payout objects in list response.

​
Success Response

{
  "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"
}

​
Next Steps

List Payouts

View all payouts with filters

List Deposits

View incoming deposits