Skip to main content
GET
/
v1
/
deposits
List all deposits
curl --request GET \
  --url https://api.daya.co/v1/deposits \
  --header 'X-Api-Key: <x-api-key>'
{
  "data": [
    {
      "id": "7a4e8400-e29b-41d4-a716-446655440000",
      "type": "NGN_DEPOSIT",
      "funding_account_id": "6b0e8400-e29b-41d4-a716-446655440000",
      "onramp_id": "550e8400-e29b-41d4-a716-446655440000",
      "customer_id": "650e8400-e29b-41d4-a716-446655440000",
      "amount": "15000.00",
      "currency": "NGN",
      "settled_amount": "9.70",
      "settled_currency": "USDC",
      "rate": "1545.50",
      "rate_id": "rate_8x7k2mq9p",
      "status": "COMPLETED",
      "settlement_status": "COMPLETED",
      "settlement_mode": "ONCHAIN",
      "chain": "BASE",
      "tx_hash": "0x8f3e2d1c0b9a8e7f6d5c4b3a2e1f0d9c8b7a6e5f4d3c2b1a",
      "fees": {
        "deposit_fee": { "amount": "0.05", "currency": "USD" },
        "total_fee_usd": "0.05"
      },
      "created_at": "2026-01-14T15:06:30Z",
      "updated_at": "2026-01-14T15:08:15Z"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 1,
  "total_pages": 1
}

​
Overview

Retrieve a paginated list of deposits for the authenticated merchant. Deposits are inbound NGN and crypto funds received through funding accounts, such as NGN virtual accounts and crypto addresses.
Use USD account deposits for payments into USD virtual accounts.

​
Authentication

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

​
Query Parameters

​
type
string
Filter by deposit typeAllowed values: NGN_DEPOSIT | CRYPTO_DEPOSIT
​
status
string
Filter by deposit statusAllowed values: PENDING | RECEIVED | PROCESSING | REQUIRES_REVIEW | COMPLETED | FLAGGED | FAILED | REVERSEDFLAGGED is accepted for older integrations and maps to REQUIRES_REVIEW.
​
payment_reference
string
Filter by exact payment reference. Only applies to NGN deposits.
​
onramp_id
string
Filter by legacy onramp ID (UUID). Only applies to migrated NGN deposits.Example: 550e8400-e29b-41d4-a716-446655440000
​
offramp_id
string
Filter by legacy offramp ID (UUID). Only applies to migrated crypto deposits.Example: 550e8400-e29b-41d4-a716-446655440000
​
from
string
Filter deposits created from this time (RFC 3339, inclusive).Example: 2026-01-01T00:00:00Z
​
to
string
Filter deposits created before this time (RFC 3339, exclusive).Example: 2026-01-31T23:59:59Z
​
limit
integer
Results per pageDefault: 50 | Max: 200
​
page
integer
Page number to retrieveDefault: 1

​
Request Examples

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

​
Response

​
data
array
required
Array of deposit objects.
​
page
integer
required
Current page number.
​
limit
integer
required
Results per page.
​
total
integer
required
Total number of deposits matching filters.
​
total_pages
integer
required
Total number of pages available.

​
Success Response

{
  "data": [
    {
      "id": "7a4e8400-e29b-41d4-a716-446655440000",
      "type": "NGN_DEPOSIT",
      "funding_account_id": "6b0e8400-e29b-41d4-a716-446655440000",
      "onramp_id": "550e8400-e29b-41d4-a716-446655440000",
      "customer_id": "650e8400-e29b-41d4-a716-446655440000",
      "amount": "15000.00",
      "currency": "NGN",
      "settled_amount": "9.70",
      "settled_currency": "USDC",
      "rate": "1545.50",
      "rate_id": "rate_8x7k2mq9p",
      "status": "COMPLETED",
      "settlement_status": "COMPLETED",
      "settlement_mode": "ONCHAIN",
      "chain": "BASE",
      "tx_hash": "0x8f3e2d1c0b9a8e7f6d5c4b3a2e1f0d9c8b7a6e5f4d3c2b1a",
      "fees": {
        "deposit_fee": { "amount": "0.05", "currency": "USD" },
        "total_fee_usd": "0.05"
      },
      "created_at": "2026-01-14T15:06:30Z",
      "updated_at": "2026-01-14T15:08:15Z"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 1,
  "total_pages": 1
}

​
Next Steps

Get Deposit

Get a specific deposit by ID

Deposits Concept

Learn about deposit lifecycle