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

# Create a return

`POST /api/service/return/create`

Creates a return for a deposit.

## Request body

- CreateReturnRequestDto
  - `depositId` string, uuid, required — The ID of the associated deposit

## Response `200`

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

- **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/create/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)