--- title: Deprecated API calls description: Retrieve deprecated API calls made by the authenticated custom app in the past 30 days. api_version: 2025-10 api_name: admin-rest api_type: rest source_url: html: https://shopify.dev/docs/api/admin-rest/latest/resources/deprecated-api-calls md: https://shopify.dev/docs/api/admin-rest/latest/resources/deprecated-api-calls.md --- ![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg) The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate). # Deprecated API calls Custom apps The Deprecated API calls resource is available only for [custom](https://shopify.dev/concepts/apps#custom-apps) 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](https://shopify.dev/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](https://shopify.dev/api/usage/versioning). \# ## Endpoints * [get](https://shopify.dev/docs/api/admin-rest/latest/resources/deprecated-api-calls#get-deprecated-api-calls) [/admin/api/latest/deprecated\_​api\_​calls.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/deprecated-api-calls#get-deprecated-api-calls) Retrieves a list of deprecated API calls *** ## The Deprecated API calls resource ### Properties *** data\_updated\_at The date and time ([ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601)) 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: Show deprecated\_api\_calls properties * `api_type`: The type of API that the call was made to. Valid values: `REST`, `Webhook`, `GraphQL`. * `description`: A description of the deprecation and any required migration steps. * `documentation_url`: The documentation URL to the deprecated change. * `endpoint`: A description of the REST endpoint, webhook topic, or GraphQL field called. * `last_call_at`: The timestamp ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format) when the last deprecated API call was made. * `migration_deadline`: The time ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format) when the deprecated API call will be removed. * `graphql_schema_name`: The name of the GraphQL schema. If the call wasn't made to a GraphQL API, then this value is `null`. * `version`: The earliest API version to migrate to in order to avoid making the deprecated API calls. *** {} ## The Deprecated API calls resource ```json { "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" } ] } } ``` *** ## getRetrieves a list of deprecated API calls Retrieves a list of deprecated API calls made by your custom apps in the past 30 days. ### Parameters *** api\_version string required *** ### Examples Retrieves all deprecated API calls get ## /admin/api/2025-10/deprecated\_​api\_​calls.​json ```bash curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/deprecated_api_calls.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` {} ## Response JSON ```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" } ] } ``` ### examples * #### Retrieves all deprecated API calls ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/deprecated_api_calls.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` ##### ```remix await admin.rest.resources.DeprecatedApiCall.all({ session: session, }); ``` ##### ```ruby # Session is activated via Authentication test_session = ShopifyAPI::Context.active_session ShopifyAPI::DeprecatedApiCall.all( session: test_session, ) ``` ##### ```node // Session is built by the OAuth process await shopify.rest.DeprecatedApiCall.all({ session: session, }); ``` #### 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"}]} ```