API call to get order by id returns a deprecated header

Retired Boards Appdev Graphql Basics And Troubleshooting

Topic summary

Main issue: Fetching a single Order via Admin REST 2022-07 (/orders/{id}.json) returns the header X-Shopify-API-Deprecated-Reason, pointing to “Property deprecations in the Admin API Order and LineItem resource.”

Observations:

  • Even when requesting only the id field, the deprecation warning persists in response headers.
  • Fetching orders for a customer using an older version (2022-04, /customers/{id}/orders) does not trigger the warning.

Context:

  • The deprecation header indicates that one or more fields in the Order/LineItem resource are deprecated per the linked changelog, regardless of which fields the client requests, because the response resource may include deprecated properties.

Attempts/Questions:

  • Multiple users report the same behavior and ask for a resolution.

Guidance provided:

  • Review the app’s API deprecation report to identify which requests/fields must be updated.
    • For apps from the Partner Dashboard: use the API health report.
    • For apps created from a merchant’s Admin: call the Deprecated API Calls endpoint: /admin/api/2023-01/deprecated_api_calls.json.

Status:

  • No direct fix or code change was confirmed in-thread.
  • Action item is to consult the API health/deprecation reports to pinpoint and update deprecated Order/LineItem properties. The discussion remains open without a confirmed resolution.
Summarized with AI on February 1. AI used: gpt-5.
1

Hello,

I’m trying to use to Node client to interact with Shopify, instead of using direct HTTP calls.

Our version is July07

However, when I make a simple

https://shopify.dev/api/admin-rest/2022-07/resources/order#get-orders-order-id

I get a header in the response,

X-Shopify-API-Deprecated-Reason: https://shopify.dev/changelog/property-deprecations-in-the-admin-api-order-and-lineitem-resource

Hence the message:

API Deprecation Notice: {
message: ‘https://shopify.dev/changelog/property-deprecations-in-the-admin-api-order-and-lineitem-resource’,
path: ‘https://loccitane-thailand-staging.myshopify.com/admin/api/2022-07/orders/4613032771751.json’
}

However, when I try to retrieve all orders for a customers (https://shopify.dev/api/admin-rest/2022-04/resources/customer#get-customers-customer-id-orders) everything goes smoothly :slightly_smiling_face:

What am I missing?

Thanks for your help

Alex

2

yes, I have a problem as you

Are you resolve it?

Or someone resolve above problem, Please teach me. Thanks so much

3

Same problem on my end as well. How did you solve it?

1 Like
4

I’m getting the same issue. I’m only trying to get one specific order by ID. Even if I specify only the id field, the deprecation warning is still present on the request headers.

5

Hi @ccwebmaster :waving_hand:

I’d recommend reviewing the API deprecation report for your app instead, to identify the requests that need to be updated. For apps created from the partner dashboard, you can leverage the API health report, and for apps created from a merchant’s Admin, you can fetch the report via the deprecated API calls endpoint /admin/api/2023-01/deprecated_api_calls.json.

Hope that helps!