Skip to main content
GET
/
v1
/
transfers
/
{id}
Get transfer
curl --request GET \
  --url https://api.daya.co/v1/transfers/{id} \
  --header 'X-Api-Key: <x-api-key>'
{
  "id": "850e8400-e29b-41d4-a716-446655440000",
  "reference": "txn_ngn_001",
  "status": "SETTLED",
  "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": "2026-01-05T15:10:00Z"
}

​
Overview

Retrieves a single merchant-initiated transfer by ID for the authenticated merchant.

​
Authentication

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

​
Path Parameters

​
id
string
required
Transfer ID (UUID format)Example: 850e8400-e29b-41d4-a716-446655440000

​
Request Example

curl --request GET \
  --url https://api.daya.co/v1/transfers/850e8400-e29b-41d4-a716-446655440000 \
  --header 'X-Api-Key: YOUR_API_KEY'

​
Response

​
id
string
required
Transfer ID (UUID)
​
reference
string
required
Merchant-provided reference
​
status
string
required
External status: PROCESSING, SETTLED, or FAILED
​
rail
string
required
Transfer rail: NGN_BANK or USD_BANK
​
currency
string
required
Transfer currency (NGN or USD)
​
amount
string
required
Transfer amount in the target currency
​
debit_currency
string
required
Currency debited from the merchant balance (USD)
​
debit_amount
string
required
Total amount debited from the merchant withdrawal balance, including fees
​
fee
string
required
Fee charged for the transfer
​
rate
object
Captured exchange rate snapshot (present for NGN transfers)
​
recipient
object
Resolved recipient details
​
on_behalf_of
object
Customer metadata if provided
​
created_at
string
required
When the transfer was created (ISO 8601)
​
settled_at
string
When the transfer settled (ISO 8601)
{
  "id": "850e8400-e29b-41d4-a716-446655440000",
  "reference": "txn_ngn_001",
  "status": "SETTLED",
  "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": "2026-01-05T15:10:00Z"
}