---
title: "Changes to List returns"
method: GET
path: "/v1/returns"
---

# Changes to List returns

`GET /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`: 1 warning, 1 info
- **2026-08-21** `79d607871de9`: 4 breaking, 3 warning, 8 info
- **2026-08-17** `3ed0a0aba68b`: 4 info
- **2026-07-13** `d92a4abea6c4`: 3 warning
- **2026-06-17** `74deb4d45f9f`: 1 warning
- **2026-04-24** `75f9878ced37`: 4 warning
- **2026-04-21** `67983e71dc41`: 2 warning, 2 info
- **2026-04-17** `2cf119af8af8`: 1 info

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-08-26** `ca35cff0b637`: 1 warning, 1 info
  - added the new `submitted` enum value to the `data/items/status` response property for the response status `200`
  - added the new enum value `submitted` to the `query` request parameter `status`
- **2026-08-21** `79d607871de9`: 4 breaking, 3 warning, 8 info
  - removed the enum value `paid` from the `query` request parameter `status`
  - removed the enum value `pending` from the `query` request parameter `status`
  - removed the required property `data/items/created_at` from the response with the `200` status
  - removed the required property `data/items/updated_at` from the response with the `200` status
  - added the new `initiated` enum value to the `data/items/status` response property for the response status `200`
  - added the new `invalid_routing_number` enum value to the `data/items/failure/code` response property for the response status `200`
  - added the new `sent` enum value to the `data/items/status` response property for the response status `200`
  - added the new enum value `initiated` to the `query` request parameter `status`
  - added the new enum value `sent` to the `query` request parameter `status`
  - removed the `paid` enum value from the `data/items/status` response property for the response status `200`
  - removed the `pending` enum value from the `data/items/status` response property for the response status `200`
  - added the required property `data/items/initiated_at` to the response with the `200` status
  - added the required property `data/items/rail` to the response with the `200` status
  - added the required property `data/items/sent_at` to the response with the `200` status
  - added the required property `data/items/tx_hash` to the response with the `200` status
- **2026-08-17** `3ed0a0aba68b`: 4 info
  - removed the `BTC` enum value from the `data/items/currency` response property for the response status `200`
  - removed the `ETH` enum value from the `data/items/currency` response property for the response status `200`
  - removed the `POL` enum value from the `data/items/currency` response property for the response status `200`
  - removed the `SOL` enum value from the `data/items/currency` response property for the response status `200`
- **2026-07-13** `d92a4abea6c4`: 3 warning
  - added the new `ETH` enum value to the `data/items/currency` response property for the response status `200`
  - added the new `POL` enum value to the `data/items/currency` response property for the response status `200`
  - added the new `SOL` enum value to the `data/items/currency` response property for the response status `200`
- **2026-06-17** `74deb4d45f9f`: 1 warning
  - added the new `BTC` enum value to the `data/items/currency` response property for the response status `200`
- **2026-04-24** `75f9878ced37`: 4 warning
  - added the new `EUR` enum value to the `data/items/currency` response property for the response status `200`
  - added the new `GBP` enum value to the `data/items/currency` response property for the response status `200`
  - added the new `USD` enum value to the `data/items/currency` response property for the response status `200`
  - added the new `USDC` enum value to the `data/items/currency` response property for the response status `200`
- **2026-04-21** `67983e71dc41`: 2 warning, 2 info
  - deleted the `query` request parameter `created_at.after`
  - deleted the `query` request parameter `created_at.before`
  - added the new optional `query` request parameter `created_at.gte`
  - added the new optional `query` request parameter `created_at.lte`
- **2026-04-17** `2cf119af8af8`: 1 info
  - endpoint added

---

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