---
title: "List Deposits"
method: GET
path: "/v1/deposits"
tags: ["public.deposits"]
---

# List Deposits

`GET /v1/deposits`

Lists funding account deposits for NGN and crypto receive flows. When a developer fee is configured, each settled deposit shows the merchant developer fee and the customer amount separately from Daya fees.

## Query parameters

- `limit` integer
- `page` integer
- `type` 'NGN_DEPOSIT' | 'CRYPTO_DEPOSIT'
- `status` 'PENDING' | 'RECEIVED' | 'PROCESSING' | 'REQUIRES_REVIEW' | 'COMPLETED' | 'FLAGGED' | 'FAILED' | 'REVERSED'
- `payment_reference` string
- `onramp_id` string
- `offramp_id` string
- `from` string
- `to` string

## Response `200`

OK

- ListDepositsResponse
  - `data` DepositResponse[]
    - `amount` string
    - `asset` string
    - `chain` string
    - `created_at` string
    - `currency` string
    - `customer_amount` DepositCustomerAmountResponse
      - `amount` string — Amount left for the customer after Daya fees and the merchant developer fee.
      - `currency` string
    - `customer_id` string
    - `developer_fee` DepositDeveloperFeeResponse
      - `amount` string — Amount kept by the merchant. Present after the deposit has been settled.
      - `currency` string — Currency of the developer fee amount.
      - `percentage` string — Percentage kept by the merchant from this received deposit.
    - `fees` DepositFeesResponse
      - `deposit_fee` FeeAmountResponse
        - `amount` string
        - `currency` string
      - `total_fee_usd` string
      - `withdrawal_fee` FeeAmountResponse
        - `amount` string
        - `currency` string
    - `flag_code` string
    - `flag_message` string
    - `funding_account_id` string
    - `id` string
    - `offramp_id` string
    - `onramp_id` string
    - `rate` string
    - `rate_id` string
    - `sender` DepositSender
      - `account_number` string
      - `bank_name` string
      - `name` string
    - `settled_amount` string
    - `settled_currency` string
    - `settlement_mode` string
    - `settlement_status` string
    - `status` string
    - `tx_hash` string
    - `type` string
    - `updated_at` string
    - `va_deposit_id` string
  - `limit` integer
  - `page` integer
  - `total` integer
  - `total_pages` integer

## Other responses

- `400` — Invalid query parameters
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/daya/apis/daya-external-api-public-api.md) · [All operations](https://skmtc.dev/daya/apis/daya-external-api-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/daya/daya-external-api-public-api/revisions/5fc72bf91a48/schema)
