The REST Admin API is a legacy API as of October 1, 2024. All apps and integrations should be built with the GraphQL Admin API. For details and migration steps, visit our migration guide.

Anchor to section titled 'undefined'

Deprecated API calls

Custom apps

The Deprecated API calls resource is available only for custom apps.

You can call this endpoint to get a list of all the deprecated calls your custom apps have made in the past 30 days, information on migration steps, and the deadline to update these calls in your apps.

Follow the developer changelog to make sure you're aware of any breaking changes that might affect your app. You can learn more about how to update your apps in our versioning guide.

Was this section helpful?
#Endpoints
Anchor to section titled 'The Deprecated API calls resource'

The Deprecated API calls resource

Properties
data_updated_at
The date and time (ISO 8601 format) when the data was last updated.
deprecated_api_calls
A list of deprecated API calls made by the authenticated app in the past 30 days. Each object has the following properties:
Was this section helpful?
{}The Deprecated API calls resource
{
  "data_updated_at": "2020-10-13T00:15:30Z",
  "deprecated_api_calls": {
    "deprecated_api_calls": [
      {
        "api_type": "REST",
        "description": "The page filter has been removed from multiple endpoints. Use cursor-based pagination instead.",
        "documentation_url": "https://shopify.dev/api/usage/pagination-rest",
        "endpoint": "Product",
        "last_call_at": "2020-06-12T03:46:18Z",
        "migration_deadline": "2020-07-02T13:00:00Z",
        "graphql_schema_name": null,
        "version": "2019-07"
      }
    ]
  }
}
Anchor to section titled 'GET request, Retrieves a list of deprecated API calls'

get
Retrieves a list of deprecated API calls

Retrieves a list of deprecated API calls made by your custom apps in the past 30 days.
Anchor to section titled 'Parameters of Retrieves a list of deprecated API calls'

Parameters

api_version
string
required
Was this section helpful?
Anchor to section titled 'Examples of Retrieves a list of deprecated API calls'

Examples

Was this section helpful?
get
/admin/api/2024-10/deprecated_api_calls.json
Copy
curl -X GET "https://your-development-store.myshopify.com/admin/api/2024-10/deprecated_api_calls.json" \
-H "X-Shopify-Access-Token: {access_token}"
{}Response
JSON
HTTP/1.1 200 OK
{
  "data_updated_at": "2020-10-13T00:15:30Z",
  "deprecated_api_calls": [
    {
      "api_type": "REST",
      "description": "The page filter has been removed from multiple endpoints. Use cursor-based pagination instead.",
      "documentation_url": "https://shopify.dev/api/usage/pagination-rest",
      "endpoint": "Product",
      "last_call_at": "2020-06-12T03:46:18Z",
      "migration_deadline": "2020-07-02T13:00:00Z",
      "graphql_schema_name": null,
      "version": "2019-07"
    }
  ]
}