---
title: "Changes to Create return"
method: POST
path: "/v1/returns"
---

# Changes to Create return

`POST /v1/returns`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 94 revisions.

- **2026-10-16** `f7ded6c181ab`: 1 info
- **2026-08-26** `ca35cff0b637`: 2 warning
- **2026-08-21** `79d607871de9`: 3 breaking, 3 warning, 8 info
- **2026-08-17** `3ed0a0aba68b`: 4 info
- **2026-07-27** `1d6de495a31d`: 1 breaking
- **2026-07-13** `d92a4abea6c4`: 3 warning
- **2026-06-17** `74deb4d45f9f`: 1 warning
- **2026-04-24** `75f9878ced37`: 4 warning
- **2026-04-17** `2cf119af8af8`: 1 info

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-08-26** `ca35cff0b637`: 2 warning
  - removed the request property `rail`
  - added the new `submitted` enum value to the `status` response property for the response status `200`
- **2026-08-21** `79d607871de9`: 3 breaking, 3 warning, 8 info
  - the request property `rail` became required
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `updated_at` from the response with the `200` status
  - added the new `initiated` enum value to the `status` response property for the response status `200`
  - added the new `invalid_routing_number` enum value to the `failure/code` response property for the response status `200`
  - added the new `sent` enum value to the `status` response property for the response status `200`
  - the request property `rail` became nullable
  - added the new `undefined` enum value to the request property `rail`
  - removed the `paid` enum value from the `status` response property for the response status `200`
  - removed the `pending` enum value from the `status` response property for the response status `200`
  - added the required property `initiated_at` to the response with the `200` status
  - added the required property `rail` to the response with the `200` status
  - added the required property `sent_at` to the response with the `200` status
  - added the required property `tx_hash` to the response with the `200` status
- **2026-08-17** `3ed0a0aba68b`: 4 info
  - removed the `BTC` enum value from the `currency` response property for the response status `200`
  - removed the `ETH` enum value from the `currency` response property for the response status `200`
  - removed the `POL` enum value from the `currency` response property for the response status `200`
  - removed the `SOL` enum value from the `currency` response property for the response status `200`
- **2026-07-27** `1d6de495a31d`: 1 breaking
  - the `header` request parameter `Idempotency-Key` became required
- **2026-07-13** `d92a4abea6c4`: 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** `74deb4d45f9f`: 1 warning
  - added the new `BTC` enum value to the `currency` response property for the response status `200`
- **2026-04-24** `75f9878ced37`: 4 warning
  - added the new `EUR` enum value to the `currency` response property for the response status `200`
  - added the new `GBP` enum value to the `currency` response property for the response status `200`
  - added the new `USD` enum value to the `currency` response property for the response status `200`
  - added the new `USDC` enum value to the `currency` response property for the response status `200`
- **2026-04-17** `2cf119af8af8`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/augustus/apis/ivy-api/docs/v1/returns/post.md) - [API](https://skmtc.dev/augustus/apis/ivy-api.md) - [Page](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/returns/post)