Why am I still getting delivery_category deprecation alerts?

Shopify Apps

Topic summary

Issue: Multiple app developers received persistent Shopify deprecation alerts for the removed “delivery_category” field on order shipping lines.

Initial findings: Teams had upgraded to the latest API version and added deprecation logging, with no flagged calls since February. Hitting /admin/api/2024-01/deprecated_api_calls.json returned 404, and codebases did not reference the field.

Confirmation: Other developers reported the same alerts and client escalations.

Root cause (resolution): The original poster traced the issue to an outdated component still calling a legacy API version. The alerts are triggered by the API version used, not by whether the field is referenced.

Diagnostic guidance: Inspect the response header “X-Shopify-API-Deprecated-Reason” and log which endpoint/request generated it to find the offending component.

Outcome: Resolved for the OP after updating the legacy component; guidance shared for others experiencing the alerts. Discussion indicates the problem stems from hidden/older components still using deprecated API versions, not explicit field usage. Status: Effectively resolved with a clear troubleshooting method; others may need to apply the same checks.

Summarized with AI on January 2. AI used: gpt-5.
1

We are receiving repeated notifications related to the “delivery_category” deprecation, detailed here:
https://shopify.dev/changelog/removal-of-the-delivery_category-field-on-order-shipping-lines

We are unable to find the source of this alert.

** We have updated all requests to use the latest api version.

** We have deprecation logging within our app, so that we can track and update any deprecated calls. We have no indications, since Feburary, that any deprecated calls are being made. Yet, our alerts are indicating that there are still calls using this field (which we don’t reference anyway).

** Calls to the deprecated endpoint returns 404. There are no results indicating anything is calling deprecated endpoints.

/admin/api/2024-01/deprecated_api_calls.json

Any ideas on what else we can do to diagnose this issue?

2 Likes
2

Hi, we’ve been receiving these notifications as well. Have you found the cause of this at your end?

We’ve double-checked our implementation and have found no calls to the “ShippingLine” REST resource as the mail suggests.

This is troublesome, since all our clients have reached out to us regarding this.

3

Hi, I am also having the same issue.

4

We were able to find the cause, being an outdated component that was calling a legacy version of the API.

Generally, you’ll be able to find these pretty quickly, if you are looking for the response header “X-Shopify-API-Deprecated-Reason”, and then logging the endpoint that made the request.

Regardless of whether or not you are referencing the field indicated, the triggering event is the version of the API that you are making your calls to.