Issue with deprecated 'delivery_category' call to Shopify API

Retired Boards Appdev Store Design
,

Topic summary

Shopify sent deprecation warnings to app developers about the delivery_category field being removed from the ShippingLine REST Admin API, with support ending April 1, 2024. Developers must update to API version 2023-07 or later.

Common Issue:
Multiple developers report receiving these warnings despite not explicitly calling the delivery_category field in their code. Many only perform READ operations on Orders via REST Admin API and have verified no direct references to this field.

Root Cause Identified:
The issue occurs when requesting order data using API versions older than 2023-10. Even without explicitly requesting delivery_category, older API versions automatically include this field in responses, triggering the deprecation warning.

Solution:

  • Upgrade all API calls to version 2023-10 or later
  • Ensure all REST API endpoints specify the current API version
  • Check for any API calls without explicit version parameters, as these may default to older versions
  • Review webhook configurations that might be using outdated API versions

Additional Resources:
Developers can use the deprecated API calls resource object to identify which specific calls are triggering warnings.

Summarized with AI on November 8. AI used: claude-sonnet-4-5-20250929.
1

Hi everyone,

I recently received an email from a few sellers who use Shopify with this issue below. I have searched for anything to do with delivery_category but have found nothing that could assist me. Any help here would be appreciated with what this means and where I can go to change/fix this.

Thank you,

Liam

Hello there,

One or more of your apps have made deprecated API calls in the last 30 days. Support for this version will be removed on April 1, 2024. Please update the apps listed below to API version 2023-07 or later to ensure they continue to function correctly.

Store: ** Their Store Name **

App: ** My Store Name **
Breaking Changes:

  • The delivery_category field has been removed from the ShippingLine REST Admin API. View change.

To learn how to update your apps, read the custom app versioning deprecation guide. If you still have questions, chat with us in the API forums or contact us via Support.

Regards,
Shopify Apps Team

2 Likes
2

Hi - just to confirm, you’re not able to find where in your app you’re making an API call to the delivery_category field? Could your app be using a webhook that’s referencing this field? You could also use the deprecated API calls resource to return a list of any deprecated calls your app is making, to see if delivery_category is listed there.

3

I seem to be having the same issue…can’t see where in my calls I’m making the call to delivery_category field and the deprecated API calls resource does show the call to it at the time an order is placed (I have a webhook calling my system) but I’m just addressing a shipping_lines field not directly delivery_category…

4

Same issue for me, in my app I only READ Orders by Rest Admin API, no Orders write at all, no use of ShippingLine.delivery_category at all, neither read nor write. To be sure I removed WRITE permission on Rest Admin Orders, app is still working correctly, so how delivery_category attribute can be in use by my app ? My app is Python 3.8 based, I use pypy ShopifyAPI 12.4.0. could be something in such library ? Or could the “deprecation” signal generated because of some side effect from calls other than Orders ones ? No mention of deprecated calls collected by …/admin/api/2024-01/deprecated_api_calls.json. Last stable Shopify API 2024-01 version is configured for my app.

5

Hi Liam,

Any idea about this? As seen with our developers, we too have no REST calls to the ShippingLine resource.
A number of our clients have reached out to use about this issue, but after checking and double-checking our code, we can ascertain the cause of this.

6

https://shopify.dev/docs/api/ajax/reference/cart#generate-shipping-rates

7

Hi Liam,

If we changed to latest version means, Is it make any issues in our app functionality?
can you guide in this issue?

Thanks & Regards,
Prabhakaran

8

Hello,

i have the same problem but i not found any call to delivery_category i use REST ADMIN API for order and i call url /admin/api/2023-04/orders/ i must use url /admin/api/2023-07/orders/ ?

9

I am having the same issue. I have not used something like delivery_category in any of my calls, but still getting this error.

Any idea how we can fix this?

10

we have changed end print of call api for resolve.

11

You need to use 2023-10 API version or above. Even if you don’t specifically call for a delivery_category field, requesting an order is enough to trigger a deprecated warning in older versions of API. In 2023-10 the field is omitted.

12

This has been a problem for us as well, it super concerning. This last time we think its possibly caused due to a REST api to get an order id without a specific api version. This isn’t part of our core system, and more of a cleanup/reprocess step.

https://{STORE_DOMAIN}/admin/orders/{order_id}.json

Everything else has an api version specified and we are 2024-01 and later. Whats weird though is I’d assume a call without an api version should default to the latest, but that doesn’t seem to be the case.