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>'
{
  "deposits": [
    {
      "type": "NGN_DEPOSIT",
      "id": "dep_9x2k5m8p",
      "onramp_id": "onramp_3j5k8n2q",
      "offramp_id": null,
      "customer_id": "650e8400-e29b-41d4-a716-446655440000",
      "amount": "15000.00",
      "currency": "NGN",
      "settled_amount": "9.70",
      "settled_currency": "USD",
      "fee_amount": "0.05",
      "fee_currency": "USD",
      "rate": "1545.50",
      "rate_id": "rate_8x7k2mq9p",
      "status": "COMPLETED",
      "settlement_status": "COMPLETED",
      "settlement_mode": "ONCHAIN",
      "asset": null,
      "chain": "BASE",
      "tx_hash": "0x8f3e2d1c0b9a8e7f6d5c4b3a2e1f0d9c8b7a6e5f4d3c2b1a",
      "flag_code": null,
      "flag_message": null,
      "created_at": "2026-01-14T15:06:30Z",
      "updated_at": "2026-01-14T15:08:15Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "per_page": 20,
    "total_pages": 1
  }
}

​
Overview

Retrieve a paginated list of deposits with optional filtering by onramp, status, and date range.

​
Authentication

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

​
Query Parameters

​
type
string
Filter by deposit typeAllowed values: NGN_DEPOSIT, CRYPTO_DEPOSIT
​
onramp_id
string
Filter by specific onramp (for NGN deposits)Example: onramp_3j5k8n2q
​
offramp_id
string
Filter by specific offramp (for crypto deposits)Example: 550e8400-e29b-41d4-a716-446655440000
​
status
string
Filter by deposit statusAllowed values: PENDING, COMPLETED, FAILED, FLAGGED, REVERSED
​
from
string
Start date (ISO 8601 timestamp)Example: 2026-01-01T00:00:00Z
​
to
string
End date (ISO 8601 timestamp)Example: 2026-01-31T23:59:59Z
​
page
integer
Page number (1-indexed)Default: 1
​
per_page
integer
Results per pageDefault: 20Max: 100

​
Request Examples

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

​
Response

​
deposits
array
required
Array of deposit objects
​
pagination
object
required
Pagination metadata

​
Success Response

{
  "deposits": [
    {
      "type": "NGN_DEPOSIT",
      "id": "dep_9x2k5m8p",
      "onramp_id": "onramp_3j5k8n2q",
      "offramp_id": null,
      "customer_id": "650e8400-e29b-41d4-a716-446655440000",
      "amount": "15000.00",
      "currency": "NGN",
      "settled_amount": "9.70",
      "settled_currency": "USD",
      "fee_amount": "0.05",
      "fee_currency": "USD",
      "rate": "1545.50",
      "rate_id": "rate_8x7k2mq9p",
      "status": "COMPLETED",
      "settlement_status": "COMPLETED",
      "settlement_mode": "ONCHAIN",
      "asset": null,
      "chain": "BASE",
      "tx_hash": "0x8f3e2d1c0b9a8e7f6d5c4b3a2e1f0d9c8b7a6e5f4d3c2b1a",
      "flag_code": null,
      "flag_message": null,
      "created_at": "2026-01-14T15:06:30Z",
      "updated_at": "2026-01-14T15:08:15Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "per_page": 20,
    "total_pages": 1
  }
}

​
Next Steps

Get Deposit

Get a specific deposit by ID

Deposits Concept

Learn about deposit lifecycle