> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.hopnow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Deposits

> List incoming payments for an account, newest first, with filters

Deposits are incoming credits to an account — funds received into one of the account's virtual accounts (for example via a virtual-account deposit), plus other incoming account credits. Deposit endpoints are nested under the owning account (`/accounts/{account_id}/deposits`), consistent with the other money-domain resources. Deposits are addressed by an `id` with the `api_` prefix.

| Enum            | Values                                       |
| --------------- | -------------------------------------------- |
| `DepositStatus` | `pending`, `completed`, `failed`, `reversed` |

Returns a paginated list of incoming payments for the authenticated account, newest first. Results can be filtered by virtual account, status, currency, bank reference, and date range.

## Path Parameters

<ParamField path="account_id" type="string" required>
  Id of the owning account (e.g. `acct_...`).
</ParamField>

## Query Parameters

<ParamField query="page" type="integer">
  Page number. Defaults to 1; must be ≥ 1.
</ParamField>

<ParamField query="size" type="integer">
  Items per page. Defaults to 10; allowed range 1–100.
</ParamField>

<ParamField query="virtual_account_id" type="string">
  Filter by virtual account id (`va_…`).
</ParamField>

<ParamField query="id" type="string">
  Filter by deposit id (`api_…`).
</ParamField>

<ParamField query="status" type="DepositStatus">
  Filter by status: `pending`, `completed`, `failed`, or `reversed`.
</ParamField>

<ParamField query="currency" type="Currency">
  Filter by deposit currency (e.g. `USD`, `EUR`).
</ParamField>

<ParamField query="start_date" type="datetime">
  Created on or after this date (inclusive).
</ParamField>

<ParamField query="end_date" type="datetime">
  Created before this date (exclusive).
</ParamField>

<ParamField query="bank_reference" type="string">
  Exact match on the bank reference.
</ParamField>

## Response

Returns `200` with a paginated list of deposit objects.

<ResponseField name="items" type="object[]" required>
  Deposits in the current page. See the deposit object attributes under Get Deposit.
</ResponseField>

<ResponseField name="page" type="integer" required>
  Current page number.
</ResponseField>

<ResponseField name="size" type="integer" required>
  Items per page.
</ResponseField>

<ResponseField name="total" type="integer" required>
  Total items across all pages.
</ResponseField>

<ResponseField name="pages" type="integer" required>
  Total number of pages.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "items": [
      {
        "object": "deposit",
        "id": "api_14tch14q4n4nuqnev5e4h3si",
        "account_id": "acct_l2qk703k8k0b3snmtscacozu",
        "virtual_account_id": "va_hx8p1s44n47agkbev7umkkyu",
        "amount": "2500.00",
        "currency": "USD",
        "status": "completed",
        "bank_reference": "BREF-20260530-88421",
        "sender_name": "Acme Trading Ltd",
        "sender_reference": "INV-1042",
        "reason": null,
        "value_date": "2026-05-30",
        "completed_at": "2026-05-30T09:16:41Z",
        "failed_at": null,
        "failed_reason": null,
        "created": "2026-05-30T09:14:02Z",
        "updated": "2026-05-30T09:16:41Z"
      }
    ],
    "page": 1,
    "size": 10,
    "total": 1,
    "pages": 1
  }
  ```
</ResponseExample>