Skip to main content
GET
/
public
/
v1
/
deposits
/
completed
List Completed Deposits
curl --request GET \
  --url https://api.pro.daya.co/public/v1/deposits/completed \
  --header 'X-Api-Key: <x-api-key>'
{
  "success": true,
  "message": "Completed deposits retrieved successfully",
  "data": {
    "deposits": [
      {
        "id": "11111111-1111-1111-1111-111111111111",
        "type": "deposit",
        "method": "bank_transfer",
        "status": "completed",
        "amount_ngn": "500000.00",
        "fee_amount_ngn": "50.00",
        "currency": "NGN",
        "payment_provider": "flutterwave",
        "provider_transaction_id": "FLW-RFR-9001",
        "tx_ref": "txref-001",
        "originator_name": "Jane Doe",
        "matching_reference": "DAYA-REF-001",
        "reference": "INV-9001",
        "narration": "Customer top-up",
        "description": "Bank transfer deposit",
        "created_at": "2026-05-05T14:00:00Z",
        "completed_at": "2026-05-05T14:00:09Z"
      }
    ],
    "pagination": {
      "total": 137,
      "limit": 20,
      "offset": 0,
      "has_next": true
    }
  }
}

​
Overview

Returns the authenticated user’s recent completed NGN bank-transfer deposits. Bank-transfer only — on-chain deposits are not included here. Most callers should subscribe to the deposit.completed webhook instead — this endpoint exists for backfill and reconciliation when you can’t trust webhook delivery alone. Requires Read scope.

​
Authentication

​
X-Api-Key
string
required
Your API key with Read scope

​
Query Parameters

​
limit
integer
Number of records to return. Default 20, max 100.
​
offset
integer
Pagination offset. Default 0, max 1,000,000. For deeper history, prefer paging by from/to windows over large offsets.
​
from
string
Start timestamp. RFC3339 (2026-05-01T00:00:00Z) or YYYY-MM-DD accepted.
​
to
string
End timestamp. Same accepted formats as from.

​
Request Example

curl --request GET \
  --url 'https://api.pro.daya.co/public/v1/deposits/completed?limit=20&from=2026-05-01' \
  --header 'X-Api-Key: daya_sk_YOUR_API_KEY'

​
Response

​
data.deposits
array
required
Array of completed deposit records, newest first.
​
data.pagination
object
required
{
  "success": true,
  "message": "Completed deposits retrieved successfully",
  "data": {
    "deposits": [
      {
        "id": "11111111-1111-1111-1111-111111111111",
        "type": "deposit",
        "method": "bank_transfer",
        "status": "completed",
        "amount_ngn": "500000.00",
        "fee_amount_ngn": "50.00",
        "currency": "NGN",
        "payment_provider": "flutterwave",
        "provider_transaction_id": "FLW-RFR-9001",
        "tx_ref": "txref-001",
        "originator_name": "Jane Doe",
        "matching_reference": "DAYA-REF-001",
        "reference": "INV-9001",
        "narration": "Customer top-up",
        "description": "Bank transfer deposit",
        "created_at": "2026-05-05T14:00:00Z",
        "completed_at": "2026-05-05T14:00:09Z"
      }
    ],
    "pagination": {
      "total": 137,
      "limit": 20,
      "offset": 0,
      "has_next": true
    }
  }
}