---
title: "Changes to List purchase orders"
method: GET
path: "/purchaseorders"
---

# Changes to List purchase orders

`GET /purchaseorders`

> Every recorded change to this operation, newest first.
> 30 revisions in range; 1 not diffed.

## Timeline

Changed in 3 of 30 revisions.

- **2026-10-15** `798ec5734e1a`: 7 warning
- **2026-08-20** `64746cdb0db4`: 2 info
- **2026-08-08** `222e6fad7c1f`: 1 breaking, 12 warning, 10 info

## Changes

- **2026-10-15** `798ec5734e1a`: 7 warning
  - added the new `APPROVED` enum value to the `purchaseOrders/items/status` response property for the response status `200`
  - added the new `CANCELED` enum value to the `purchaseOrders/items/status` response property for the response status `200`
  - added the new `COMPLETED` enum value to the `purchaseOrders/items/status` response property for the response status `200`
  - added the new `DECLINED` enum value to the `purchaseOrders/items/status` response property for the response status `200`
  - added the new `PARTIALLY_FULFILLED` enum value to the `purchaseOrders/items/status` response property for the response status `200`
  - added the new `PENDING` enum value to the `purchaseOrders/items/status` response property for the response status `200`
  - added the new `REQUESTED` enum value to the `purchaseOrders/items/status` response property for the response status `200`
- **2026-08-20** `64746cdb0db4`: 2 info
  - the response property `nextCursor` became required for the status `200`
  - the response property `nextPageUrl` became required for the status `200`
- **2026-08-08** `222e6fad7c1f`: 1 breaking, 12 warning, 10 info
  - the response property `purchaseOrders/items/status` became nullable for the status `200`
  - removed the optional property `purchaseOrders/items/attachments` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/billingAddress` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/costs` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/dueDate` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/items` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/note` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/overrideNumber` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/reviewNote` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/shippingAddress` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/thumbnail` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/vendorContactIds` from the response with the `200` status
  - removed the optional property `purchaseOrders/items/vendorId` from the response with the `200` status
  - added the new optional `header` request parameter `x-organization-id`
  - added the new optional `query` request parameter `createdAt[gte]`
  - added the new optional `query` request parameter `createdAt[lte]`
  - added the new optional `query` request parameter `customFieldName`
  - added the new optional `query` request parameter `sort`
  - added the new optional `query` request parameter `statuses`
  - added the new optional `query` request parameter `updatedAt[gte]`
  - added the new optional `query` request parameter `updatedAt[lte]`
  - added the optional property `purchaseOrders/items/createdAt` to the response with the `200` status
  - added the optional property `purchaseOrders/items/updatedAt` to the response with the `200` status

---

[Operation](https://skmtc.dev/getmaintainx/apis/maintainx-api/docs/purchaseorders/get.md) - [API](https://skmtc.dev/getmaintainx/apis/maintainx-api.md) - [Page](https://skmtc.dev/getmaintainx/apis/maintainx-api/changes/purchaseorders/get)