# API Announcements

**URL:** https://forums.ordoro.com/c/api-announcements/5.md

[Latest](https://forums.ordoro.com/latest.md) · [Categories](https://forums.ordoro.com/categories.md) · [Tags](https://forums.ordoro.com/tags.md)

---

## [About the API Announcements category](https://forums.ordoro.com/t/about-the-api-announcements-category/14)

<div class="topic-metadata">

**Author:** [@vince](https://forums.ordoro.com/u/vince)\
**Replies:** 0\
**Last updated:** [July 14, 2016, 9:16pm UTC](https://forums.ordoro.com/t/about-the-api-announcements-category/14 "2016-07-14T21:16:34Z")

</div>

The API Announcements category will be the home for all API release information from the Ordoro developers team. Topics should have a release date, version number, list of any breaking changes to the API and optionally a…

---

## [Deprecation of Authentication via email and password in favor of API Keys](https://forums.ordoro.com/t/deprecation-of-authentication-via-email-and-password-in-favor-of-api-keys/2082)

<div class="topic-metadata">

**Author:** [@sophie](https://forums.ordoro.com/u/sophie)\
**Replies:** 0\
**Last updated:** [September 16, 2026, 5:19pm UTC](https://forums.ordoro.com/t/deprecation-of-authentication-via-email-and-password-in-favor-of-api-keys/2082 "2026-09-16T17:19:37Z")

</div>

FINAL NOTICE This is a final notice of deprecation of email and password use for Basic Authentication to the Ordoro API. Deprecation Dates: The final date for this usage will be September 30th. As of October 1st, any re…

---

## [Important changes to order tag endpoints](https://forums.ordoro.com/t/important-changes-to-order-tag-endpoints/2055)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 1\
**Last updated:** [June 25, 2026, 3:19pm UTC](https://forums.ordoro.com/t/important-changes-to-order-tag-endpoints/2055 "2026-06-25T15:19:26Z")

</div>

Release Date August 4, 2026 Relevant Endpoints POST /v3/order/\<order\_number\>/tag/\<tag\_id\> DELETE /v3/order/\<order\_number\>/tag/\<tag\_id\> POST /v3/order/\<order\_number\>/tag\_by\_name/\<tag\_name\> DELETE /v3/order/\<order\_number\>…

---

## [Deprecation of V3 Tag endpoints](https://forums.ordoro.com/t/deprecation-of-v3-tag-endpoints/2048)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 0\
**Last updated:** [May 7, 2026, 8:51pm UTC](https://forums.ordoro.com/t/deprecation-of-v3-tag-endpoints/2048 "2026-05-07T20:51:30Z")

</div>

The following endpoints are being deprecated: /v3/tag /v3/tag/\<tag\_id\> Going forward you will want to use the following: /v3/order/tag /v3/order/tag/\<name\> If you need to fetch a tag by id, you can search by id. For …

---

## [Deprecation of on\_hand](https://forums.ordoro.com/t/deprecation-of-on-hand/2044)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 0\
**Last updated:** [February 25, 2026, 7:30pm UTC](https://forums.ordoro.com/t/deprecation-of-on-hand/2044 "2026-02-25T19:30:13Z")

</div>

Release Date April 1, 2026 Breaking Changes The on\_hand key when creating or fetching products/inventory is being deprecated in favor of physical\_on\_hand It will be removed from all relevant request and response shapes…

---

## [Upcoming final deprecation of V2 order endpoints](https://forums.ordoro.com/t/upcoming-final-deprecation-of-v2-order-endpoints/1142)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 0\
**Last updated:** [February 22, 2023, 2:40pm UTC](https://forums.ordoro.com/t/upcoming-final-deprecation-of-v2-order-endpoints/1142 "2023-02-22T14:40:52Z")

</div>

Release Date April 1, 2023 Upcoming Deprecation of remaining V2 Order endpoints As part of our move to Orders V3, we will be deprecating the remaining V2 order endpoints including GET endpoints If you are using V3 orde…

---

## [API - Upcoming changes for filtering orders using tags](https://forums.ordoro.com/t/api-upcoming-changes-for-filtering-orders-using-tags/968)

<div class="topic-metadata">

**Author:** [@julian](https://forums.ordoro.com/u/julian)\
**Replies:** 4\
**Last updated:** [November 16, 2022, 6:02pm UTC](https://forums.ordoro.com/t/api-upcoming-changes-for-filtering-orders-using-tags/968 "2022-11-16T18:02:18Z")

</div>

Upcoming API changes related to order filtering using tags Release Date Tue Nov 15th, 2022 Breaking Changes GET /v3/order will no longer support not as a value for the tag\_filter\_by param. Currently, the API offers ta…

---

## [API - V3 Product Endpoint Deprecation](https://forums.ordoro.com/t/api-v3-product-endpoint-deprecation/862)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 0\
**Last updated:** [March 8, 2022, 5:29pm UTC](https://forums.ordoro.com/t/api-v3-product-endpoint-deprecation/862 "2022-03-08T17:29:20Z")

</div>

Release Date Tuesday April 5, 2022 Breaking Changes The /v3/product endpoint will be removed from the API Any requests to it will fail with a 404 status code More information This unused endpoint is being removed in f…

---

## [API Update: v2 Deprecation Notice](https://forums.ordoro.com/t/api-update-v2-deprecation-notice/844)

<div class="topic-metadata">

**Author:** [@sophie](https://forums.ordoro.com/u/sophie)\
**Replies:** 0\
**Last updated:** [February 14, 2022, 6:07pm UTC](https://forums.ordoro.com/t/api-update-v2-deprecation-notice/844 "2022-02-14T18:07:59Z")

</div>

Release Date Wed March 1, 2022 Note to current API Users: Related to ongoing v2 /order/ deprecation, we are removing the v2 order split endpoint. If you are using an Ordoro v3 account to make API requests, this should …

---

## [Deprecated Shipment Rate and Label Endpoints and Package Attributes](https://forums.ordoro.com/t/deprecated-shipment-rate-and-label-endpoints-and-package-attributes/827)

<div class="topic-metadata">

**Author:** [@sophie](https://forums.ordoro.com/u/sophie)\
**Replies:** 2\
**Last updated:** [January 24, 2022, 7:04pm UTC](https://forums.ordoro.com/t/deprecated-shipment-rate-and-label-endpoints-and-package-attributes/827 "2022-01-24T19:04:29Z")

</div>

Release Date Tue Feb 1, 2022 Breaking Changes This is a follow up and official announcement of the deprecation of top-level package attributes in a rate or label request. This is also a follow up related to v2 to v3 API…

---

## [Follow Up: Deprecation Update: DELETE /purchase\_order/](https://forums.ordoro.com/t/follow-up-deprecation-update-delete-purchase-order/810)

<div class="topic-metadata">

**Author:** [@sophie](https://forums.ordoro.com/u/sophie)\
**Replies:** 0\
**Last updated:** [October 15, 2021, 10:22pm UTC](https://forums.ordoro.com/t/follow-up-deprecation-update-delete-purchase-order/810 "2021-10-15T22:22:10Z")

</div>

DELETE /purchase\_order/ will soon be deprecated. Please use POST /purchase\_order/:po\_id/cancel/ to cancel your purchase order As a follow up to our previous post and reiteration: We are changing the way we cancel Purch…

---

## [Upcoming Deprecation and API Change - DELETE /purchase\_order/](https://forums.ordoro.com/t/upcoming-deprecation-and-api-change-delete-purchase-order/784)

<div class="topic-metadata">

**Author:** [@sophie](https://forums.ordoro.com/u/sophie)\
**Replies:** 0\
**Last updated:** [September 3, 2021, 5:24pm UTC](https://forums.ordoro.com/t/upcoming-deprecation-and-api-change-delete-purchase-order/784 "2021-09-03T17:24:34Z")

</div>

DELETE /purchase\_order/ We are changing the way we cancel Purchase Orders in the API. Rather than setting a status for cancelled purchase orders, we will have a cancelled\_date key serialized on the response. What this …

---

## [New Beta Documentation & URL Deprecation](https://forums.ordoro.com/t/new-beta-documentation-url-deprecation/732)

<div class="topic-metadata">

**Author:** [@sophie](https://forums.ordoro.com/u/sophie)\
**Replies:** 0\
**Last updated:** [June 16, 2021, 7:02pm UTC](https://forums.ordoro.com/t/new-beta-documentation-url-deprecation/732 "2021-06-16T19:02:55Z")

</div>

Announcement We will be releasing a new version of API documentation for API developers. This documentation will include all API endpoints for you to use in one form rather than the two we have had available for years. P…

---

## [Breaking changes to product fulfillment](https://forums.ordoro.com/t/breaking-changes-to-product-fulfillment/605)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 0\
**Last updated:** [September 8, 2020, 4:39pm UTC](https://forums.ordoro.com/t/breaking-changes-to-product-fulfillment/605 "2020-09-08T16:39:45Z")

</div>

Release Date September 1, 2020 Breaking Changes We are in the process of cleaning up how product fulfillment statuses are handled in the API. Previously, stocked\_inhouse and automatic\_dropshipping were set with the…

---

## [API - Product counts endpoint deprecation](https://forums.ordoro.com/t/api-product-counts-endpoint-deprecation/581)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 0\
**Last updated:** [July 15, 2020, 4:26pm UTC](https://forums.ordoro.com/t/api-product-counts-endpoint-deprecation/581 "2020-07-15T16:26:16Z")

</div>

Release Date July 21, 2020 Breaking Changes In an upcoming release, we will be deprecating the /product/counts/ endpoint The endpoint will return a 400 status and deprecation message

---

## [Changes to kit component endpoint](https://forums.ordoro.com/t/changes-to-kit-component-endpoint/565)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 0\
**Last updated:** [May 20, 2020, 3:37pm UTC](https://forums.ordoro.com/t/changes-to-kit-component-endpoint/565 "2020-05-20T15:37:05Z")

</div>

Release Date Wednesday May 20th, 2020 Breaking Changes None Other Changes Kit components will now be created or updated with the kit component PUT endpoint. Previously, components could only be added to a product via…

---

## [Upcoming changes to date sorting for order endpoint](https://forums.ordoro.com/t/upcoming-changes-to-date-sorting-for-order-endpoint/561)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 0\
**Last updated:** [May 4, 2020, 10:09pm UTC](https://forums.ordoro.com/t/upcoming-changes-to-date-sorting-for-order-endpoint/561 "2020-05-04T22:09:47Z")

</div>

Release Date Tuesday May 5th, 2020 Breaking Changes None Other Changes Sortable date fields will sort NULLS LAST if supplied in the GET order endpoint regardless of sort direction Previously, NULL dates would appear …

---

## [API Rate Limiting](https://forums.ordoro.com/t/api-rate-limiting/483)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 0\
**Last updated:** [November 4, 2019, 3:46pm UTC](https://forums.ordoro.com/t/api-rate-limiting/483 "2019-11-04T15:46:54Z")

</div>

Release Date November 4th, 2019 Breaking Changes In preparation for the holiday season, we are introducing rate liming for our API users. API requests will be limited to 500 requests per minute per company. If you reach…

---

## [API v2 and v3 deprecation](https://forums.ordoro.com/t/api-v2-and-v3-deprecation/461)

<div class="topic-metadata">

**Author:** [@sophie](https://forums.ordoro.com/u/sophie)\
**Replies:** 2\
**Last updated:** [September 13, 2019, 2:31pm UTC](https://forums.ordoro.com/t/api-v2-and-v3-deprecation/461 "2019-09-13T14:31:50Z")

</div>

Release Date Full Deprecation expected by 2019-10-15. Continued rollout begins 2019-09-15. Breaking Changes If you are on v3 of Ordoro, which a majority of users are, you will no longer be allowed to POST/PUT/DELETE t…

---

## [Breaking changes to product endpoint](https://forums.ordoro.com/t/breaking-changes-to-product-endpoint/435)

<div class="topic-metadata">

**Author:** [@syork](https://forums.ordoro.com/u/syork)\
**Replies:** 0\
**Last updated:** [July 30, 2019, 7:56pm UTC](https://forums.ordoro.com/t/breaking-changes-to-product-endpoint/435 "2019-07-30T19:56:43Z")

</div>

Release Date July 30, 2019 Breaking Changes We are changing the way our GET /product/ endpoint behaves. Previously, the endpoint accepted a status param with one of the following statuses: kit\_parent kit\_component low…

---

## [API Release Jul 9, 2018](https://forums.ordoro.com/t/api-release-jul-9-2018/263)

<div class="topic-metadata">

**Author:** [@sophie](https://forums.ordoro.com/u/sophie)\
**Replies:** 0\
**Last updated:** [July 10, 2018, 12:43am UTC](https://forums.ordoro.com/t/api-release-jul-9-2018/263 "2018-07-10T00:43:55Z")

</div>

Release Date Monday Jul 9, 2018 Version Number 1.590.0 Breaking Changes Prerequisite changes for connecting sales channel locations with warehouses. Response for /cart/:cart id/warehouse/ Previous Response // http…

---

## [API Release 4/18/2018](https://forums.ordoro.com/t/api-release-4-18-2018/220)

<div class="topic-metadata">

**Author:** [@sophie](https://forums.ordoro.com/u/sophie)\
**Replies:** 0\
**Last updated:** [April 19, 2018, 7:19pm UTC](https://forums.ordoro.com/t/api-release-4-18-2018/220 "2018-04-19T19:19:47Z")

</div>

Release Date 2018-04-18 Version Number 1.528.0 Notable Changes The V3 Order API will now include a display\_shipping\_method key in the shipping\_info portion of the Order body response and shipping\_info response after a…

---

## [New Parent/Child order behavior](https://forums.ordoro.com/t/new-parent-child-order-behavior/194)

<div class="topic-metadata">

**Author:** [@darrell](https://forums.ordoro.com/u/darrell)\
**Replies:** 0\
**Last updated:** [April 4, 2018, 8:43pm UTC](https://forums.ordoro.com/t/new-parent-child-order-behavior/194 "2018-04-04T20:43:06Z")

</div>

In preparation for some upcoming backend v3 order api changes, we have separated orders into 2 different shapes: parent and child orders. See https://devapiverson.docs.apiary.io/ The /order/\<order\_number\> endpoint will…

---

## [Anticipated Breaking Changes: Order rate and label endpoints; Shipment label endpoints](https://forums.ordoro.com/t/anticipated-breaking-changes-order-rate-and-label-endpoints-shipment-label-endpoints/168)

<div class="topic-metadata">

**Author:** [@sophie](https://forums.ordoro.com/u/sophie)\
**Replies:** 1\
**Last updated:** [March 22, 2018, 4:43pm UTC](https://forums.ordoro.com/t/anticipated-breaking-changes-order-rate-and-label-endpoints-shipment-label-endpoints/168 "2018-03-22T16:43:20Z")

</div>

Release Date Changes Available to use: Wed Mar 7, 2018. Estimated Dates: Changes Available to use: Wed Mar 7, 2018. Breaking Deprecation Date: Tue Mar 20, 2018. TBD, Support will continue for the time being. Version …

---

## [API label/rate endpoint deprecation on 2017-09-30](https://forums.ordoro.com/t/api-label-rate-endpoint-deprecation-on-2017-09-30/147)

<div class="topic-metadata">

**Author:** [@darrell](https://forums.ordoro.com/u/darrell)\
**Replies:** 0\
**Last updated:** [August 30, 2017, 9:27pm UTC](https://forums.ordoro.com/t/api-label-rate-endpoint-deprecation-on-2017-09-30/147 "2017-08-30T21:27:08Z")

</div>

Release Date Sat September 30, 2017 Breaking Changes api.ordoro.com endpoints to kill label & rate endpoints/shipment/:shipment\_id/label/generate/ \[POST\] /shipment/:shipment\_id/label/rate/ \[GET\] /shipment/:shipment\_i…

---

## [API Release 7/14/16](https://forums.ordoro.com/t/api-release-7-14-16/20)

<div class="topic-metadata">

**Author:** [@vince](https://forums.ordoro.com/u/vince)\
**Replies:** 0\
**Last updated:** [July 15, 2016, 3:28pm UTC](https://forums.ordoro.com/t/api-release-7-14-16/20 "2016-07-15T15:28:07Z")

</div>

Release Date Thurs July 14, 216 Version Number 1.49.0 Breaking Changes There are no breaking changes in this release. New Features We have upgraded our kitting algorithm to be more efficient and offer better su…

---

## [Planned Downtime for Evening of 7/14/16](https://forums.ordoro.com/t/planned-downtime-for-evening-of-7-14-16/16)

<div class="topic-metadata">

**Author:** [@vince](https://forums.ordoro.com/u/vince)\
**Replies:** 0\
**Last updated:** [July 14, 2016, 9:35pm UTC](https://forums.ordoro.com/t/planned-downtime-for-evening-of-7-14-16/16 "2016-07-14T21:35:53Z")

</div>

We will be performing a production deployment this evening. The planned outage is for 10PM to 12A CST - though the outage will more than likely be much, much shorter than that. With this deployment, we will be performi…
