---
title: "Changes to Retrieve user's orders"
method: GET
path: "/api/oms/user/orders"
---

# Changes to Retrieve user's orders

`GET /api/oms/user/orders`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 62 revisions.

- **2026-02-10** `4be2d9ba0a4e`: 3 info
- **2026-02-10** `fe60a05647a0`: 1 warning
- **2026-02-03** `99b6d8daeb7e`: 1 info
- **2026-02-02** `f6d7493fa46e`: 5 info

## Changes

- **2026-02-10** `4be2d9ba0a4e`: 3 info
  - the `query` request parameter `clientEmail` became optional
  - the `query` request parameter `page` became optional
  - the `query` request parameter `per_page` became optional
- **2026-02-10** `fe60a05647a0`: 1 warning
  - deleted the `query` request parameter `contactsInformationHashed`
- **2026-02-03** `99b6d8daeb7e`: 1 info
  - added the new optional `query` request parameter `contactsInformationHashed`
- **2026-02-02** `f6d7493fa46e`: 5 info
  - added the new optional `query` request parameter `creation_date`
  - added the new optional `query` request parameter `my_pending_approvals`
  - added the new optional `query` request parameter `purchase_agent_id`
  - added the new optional `query` request parameter `status`
  - added the new optional `query` request parameter `text`

---

[Operation](https://skmtc.dev/vtex/apis/orders-api/docs/api/oms/user/orders/get.md) - [API](https://skmtc.dev/vtex/apis/orders-api.md) - [Page](https://skmtc.dev/vtex/apis/orders-api/changes/api/oms/user/orders/get)