---
title: "Retrieve a deposit"
method: POST
path: "/api/service/deposit/retrieve"
tags: ["Deposit"]
---

# Retrieve a deposit

`POST /api/service/deposit/retrieve`

Retrieves a deposit by its ID.

## Request body

- RerieveDepositRequestDto
  - `id` string, uuid, required — The ID of the deposit

## Response `200`

Deposit retrieved successfully

- RetrieveDepositResponseDto
  - `id` string, uuid, required — The ID of the deposit
  - `status` 'received', required — The status of the deposit
  - `amount` number, required — The amount of the deposit
  - `transactionId` string, uuid, required — The ID of the transaction that initiated the deposit
  - `currency` 'EUR' | 'GBP' | 'PLN' | 'SEK' | 'DKK' | 'USD' | 'USDC' | 'BTC' | 'ETH' | 'SOL' | 'POL', required — The currency of the deposit
  - `receivedAt` string, date-time, required — The date and time the deposit was received
  - `payer` object, required — The payer account identifier
    - `type` 'iban' | 'sort_code' | 'bank_code' | 'bban' | 'wallet' | 'aba', required
    - `iban` object
      - `accountHolderName` string, required
      - `iban` string, required
      - `bic` string
    - `aba` object
      - `accountHolderName` string, required
      - `routingNumber` string, required
      - `accountNumber` string, required
    - `sortCode` object
      - `accountHolderName` string, required
      - `sortCode` string, required
      - `accountNumber` string, required
    - `bankCode` object
      - `accountHolderName` string, required
      - `code` string, required
      - `accountNumber` string, required
    - `bban` object
      - `accountHolderName` string, required
      - `bban` string, required
      - `bic` string
    - `wallet` object
      - `address` string, required — The blockchain wallet address
      - `blockchain` 'BTC' | 'BTC-TESTNET4' | 'ETH' | 'ETH-SEPOLIA' | 'SOL' | 'SOL-DEVNET' | 'MATIC' | 'MATIC-AMOY', required — The blockchain network
  - `payee` object, required — The payee account identifier
    - `type` 'iban' | 'sort_code' | 'bank_code' | 'bban' | 'wallet' | 'aba', required
    - `iban` object
      - `accountHolderName` string, required
      - `iban` string, required
      - `bic` string
    - `aba` object
      - `accountHolderName` string, required
      - `routingNumber` string, required
      - `accountNumber` string, required
    - `sortCode` object
      - `accountHolderName` string, required
      - `sortCode` string, required
      - `accountNumber` string, required
    - `bankCode` object
      - `accountHolderName` string, required
      - `code` string, required
      - `accountNumber` string, required
    - `bban` object
      - `accountHolderName` string, required
      - `bban` string, required
      - `bic` string
    - `wallet` object
      - `address` string, required — The blockchain wallet address
      - `blockchain` 'BTC' | 'BTC-TESTNET4' | 'ETH' | 'ETH-SEPOLIA' | 'SOL' | 'SOL-DEVNET' | 'MATIC' | 'MATIC-AMOY', required — The blockchain network
  - `bankStatementReference` string — The reference that appears on the bank statement
  - `rail` 'sepa_instant' | 'faster_payments' | 'sepa' | 'elixir' | 'express_elixir' | 'sek_account_to_account' | 'sumclearing' | 'straksclearing' | 'swift' | 'internal' | 'target' | 'ach' | 'fedwire' | 'BTC' | 'BTC-TESTNET4' | 'ETH' | 'ETH-SEPOLIA' | 'SOL' | 'SOL-DEVNET' | 'MATIC' | 'MATIC-AMOY' — The payment rail or blockchain used for the deposit
  - `txHash` string — The transaction hash for crypto deposits
  - `returns` object[], required
    - `id` string, uuid, required — The ID of the return
    - `depositId` string, uuid, required — The ID of the associated deposit
    - `transactionId` string, uuid — The ID of the resulting return transaction
    - `status` 'initiated' | 'succeeded' | 'failed' | 'returned', required — The status of the return
    - `amount` number, required — The amount of the return
    - `currency` 'EUR' | 'GBP' | 'PLN' | 'SEK' | 'DKK' | 'USD' | 'USDC' | 'BTC' | 'ETH' | 'SOL' | 'POL', required — The currency of the return
    - `createdAt` string, date-time, required — The date and time the return was created
    - `failedAt` string, date-time — The date and time the return failed if applicable
    - `succeededAt` string, date-time — The date and time the return succeeded if applicable

## Changes

- **2026-07-10** `d9c9345c8479` — 6 warning
  - added the new `ETH` enum value to the `currency` response property for the response status `200`
  - added the new `ETH` enum value to the `returns/items/currency` response property for the response status `200`
  - added the new `POL` enum value to the `currency` response property for the response status `200`
  - added the new `POL` enum value to the `returns/items/currency` response property for the response status `200`
  - …2 more
- **2026-06-17** `3ed3cb51802c` — 8 warning
  - added the new `BTC` enum value to the `currency` response property for the response status `200`
  - added the new `BTC` enum value to the `payee/wallet/blockchain` response property for the response status `200`
  - added the new `BTC` enum value to the `payer/wallet/blockchain` response property for the response status `200`
  - added the new `BTC` enum value to the `rail` response property for the response status `200`
  - …4 more
- **2026-05-28** `985fef88525b` — 2 warning
  - added the new `ach` enum value to the `rail` response property for the response status `200`
  - added the new `fedwire` enum value to the `rail` response property for the response status `200`
- **2026-05-06** `f133fdf6c9bd` — 2 info
  - added the optional property `payee/aba` to the response with the `200` status
  - added the optional property `payer/aba` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/augustus/apis/ivy-api/changes/api/service/deposit/retrieve/post.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-service-production.skmtc.workers.dev/v1/apis/augustus/ivy-api/revisions/c3055fc06ca3/schema)