---
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

---

[API](https://skmtc.net/augustus/apis/ivy-api.md) · [All operations](https://skmtc.net/augustus/apis/ivy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/augustus/ivy-api/revisions/c3055fc06ca3/schema)