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

# Retrieve a return

`POST /api/service/return/retrieve`

Retrieves a return by its ID.

## Request body

- RerieveReturnRequestDto
  - `id` string, uuid, required — The ID of the return

## Response `200`

Return retrieved successfully

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

> 48 revisions in range; 2 could not be searched.

- **2026-07-10** `d9c9345c8479` — 3 warning
  - added the new `ETH` enum value to the `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 `SOL` enum value to the `currency` response property for the response status `200`
- **2026-06-17** `3ed3cb51802c` — 1 warning
  - added the new `BTC` enum value to the `currency` response property for the response status `200`
- **2026-04-29** `84194dfc43b4` — 1 warning
  - added the new `USD` enum value to the `currency` response property for the response status `200`
- **2025-10-17** `102fab1c7e1a` — 1 warning
  - added the new `USDC` enum value to the `currency` response property for the response status `200`

[Change history](https://skmtc.dev/augustus/apis/ivy-api/changes/api/service/return/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)