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

# List deposits

`GET /v1/deposits`

## Request

- Base URL: `https://api.augustus.com`
- URL: `https://api.augustus.com/v1/deposits`
- Auth: HTTP bearer

Lists deposits for the merchant with cursor-based pagination.

## Query parameters

- `limit` integer
- `cursor` string
- `settled_at.gte` string, date-time
- `settled_at.lte` string, date-time
- `rail` 'sepa' | 'sepa_instant' | 'faster_payments' | 'swift' | 'internal' | 'target' | 'ach' | 'fedwire' | 'bitcoin' | 'bitcoin_testnet4' | 'ethereum' | 'ethereum_sepolia' | 'solana' | 'solana_devnet' | 'polygon' | 'polygon_amoy'
- `currencies` string[]

## Response `200`

Paginated list of deposits

- ListDepositsResponseDto
  - `data` object[], required
    - `id` string, uuid, required: Unique identifier of the deposit.
    - `type` 'deposit', required: Resource type discriminator.
    - `status` 'settled', required: Current status of the deposit.
    - `account_id` string, uuid, required: ID of the account that was credited with the deposit.
    - `amount` string, required: Amount as a string decimal (e.g. "100.50").
    - `currency` 'EUR' | 'GBP' | 'USD' | 'USDC', required: Currency code (ISO 4217 or crypto).
    - `counterparty_id` string, uuid, nullable, required: ID of the counterparty that sent the money, or null when not known.
    - `unstructured_remittance_information` string, nullable, required: Unstructured remittance information attached to the transfer. Not all rails support this field.
    - `tracking_reference` object, nullable, required: Rail network tracking identifier with its type: UETR for SWIFT, IMAD for Fedwire, or the 15-digit trace number for ACH. Null when unavailable.
      - `type` 'uetr' | 'imad' | 'trace_number', required: Tracking reference type: UETR, IMAD, or ACH trace number.
      - `value` string, required: Rail-provided tracking identifier.
    - `rail` 'sepa' | 'sepa_instant' | 'faster_payments' | 'swift' | 'internal' | 'target' | 'ach' | 'fedwire' | 'bitcoin' | 'bitcoin_testnet4' | 'ethereum' | 'ethereum_sepolia' | 'solana' | 'solana_devnet' | 'polygon' | 'polygon_amoy' | 'null', nullable, required: Payment scheme or blockchain used for the deposit, or null when unknown.
    - `tx_hash` string, nullable, required: Transaction hash for crypto deposits, or null when not known. Only blockchain rails support this field.
    - `returns` string[], required: Array of deposit return IDs associated with this deposit.
    - `settled_at` string, date-time, required: ISO 8601 UTC timestamp when the deposit was settled.
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `has_previous` boolean, required
  - `previous_cursor` string, nullable, required

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-08-21** `79d607871de9`: 5 breaking, 12 warning, 24 info
  - removed the required property `data/items/bank_statement_reference` from the response with the `200` status
  - removed the required property `data/items/created_at` from the response with the `200` status
  - removed the required property `data/items/destination_account_id` from the response with the `200` status
  - removed the required property `data/items/source` from the response with the `200` status
  - …37 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/deposits/get.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) - [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/augustus/apis/ivy-api/revisions/e87bdcac11cc?raw)