Skip to main content
GET
https://api.daya.xyz
/
v1
/
deposits
GET /v1/deposits
curl --request GET \
  --url https://api.daya.xyz/v1/deposits \
  --header 'Authorization: <authorization>'
{
  "deposits": [
    {
      "deposit_id": "dep_9x2k5m8p",
      "onramp_id": "onramp_3j5k8n2q",
      "payment_reference": "DAYA-3J5K8N2Q",
      "user_email": "[email protected]",
      "amount_ngn": "15000.00",
      "status": "SETTLED",
      "rate_id": "rate_8x7k2mq9p",
      "amount_asset": "9.70",
      "asset": "USDC",
      "chain": "BASE",
      "tx_hash": "0x8f3e2d1c0b9a8e7f6d5c4b3a2e1f0d9c8b7a6e5f4d3c2b1a",
      "created_at": "2026-01-14T15:06:30Z",
      "settled_at": "2026-01-14T15:08:15Z",
      "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

​
Authorization
string
required
Bearer token with your API key

​
Query Parameters

​
onramp_id
string
Filter by specific onrampExample: onramp_3j5k8n2q
​
status
string
Filter by deposit statusAllowed values: PENDING_FX, PENDING_WITHDRAWAL, SETTLED, 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.xyz/v1/deposits' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Response

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

​
Success Response

{
  "deposits": [
    {
      "deposit_id": "dep_9x2k5m8p",
      "onramp_id": "onramp_3j5k8n2q",
      "payment_reference": "DAYA-3J5K8N2Q",
      "user_email": "[email protected]",
      "amount_ngn": "15000.00",
      "status": "SETTLED",
      "rate_id": "rate_8x7k2mq9p",
      "amount_asset": "9.70",
      "asset": "USDC",
      "chain": "BASE",
      "tx_hash": "0x8f3e2d1c0b9a8e7f6d5c4b3a2e1f0d9c8b7a6e5f4d3c2b1a",
      "created_at": "2026-01-14T15:06:30Z",
      "settled_at": "2026-01-14T15:08:15Z",
      "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