# Deprecated API calls

        <div class="note">
          <h4>Custom apps</h4>
          <p>The Deprecated API calls resource is available only for <a href="/concepts/apps#custom-apps">custom</a> apps.</p>
        </div>

        <p>
          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.
        </p>

        <p>
          Follow the <a href="https://shopify.dev/changelog">developer changelog</a> 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 <a href="/api/usage/versioning">versioning guide</a>.
        </p>

## Resource Properties

### Deprecated API calls

* data_updated_at:           The date and time (<a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601 format</a>) when the data was last updated.

  * Type: x-string
  * Example: "2020-10-13T00:15:30Z"
* 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:
<ul>
  <li><code>api_type</code>: The type of API that the call was made to. Valid values: <code>REST</code>, <code>Webhook</code>, <code>GraphQL</code>.</li>
  <li><code>description</code>: A description of the deprecation and any required migration steps.</li>
  <li><code>documentation_url</code>: The documentation URL to the deprecated change.</li>
  <li><code>endpoint</code>: A description of the REST endpoint, webhook topic, or GraphQL field called.</li>
  <li><code>last_call_at</code>: The timestamp (<a href="https://en.wikipedia.org/wiki/ISO_4217">ISO 4217</a> format) when the last deprecated API call was made.</li>
  <li><code>migration_deadline</code>: The time (<a href="https://en.wikipedia.org/wiki/ISO_4217">ISO 4217</a> format) when the deprecated API call will be removed.</li>
  <li><code>graphql_schema_name</code>: The name of the GraphQL schema. If the call wasn't made to a GraphQL API, then this value is <code>null</code>.</li>
  <li><code>version</code>: The earliest API version to migrate to in order to avoid making the deprecated API calls.</li>
</ul>

  * Type: x-string
  * Example: {"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"=>nil, "version"=>"2019-07"}]}
## Retrieves a list of deprecated API calls

Retrieves a list of deprecated API calls made by your custom apps in the past 30 days.

### Endpoint
/admin/api/#{api_version}/deprecated_api_calls.json (GET)

### Parameters
* api_version (required): 

### Responses
#### 200
Retrieves a list of deprecated API calls

Examples:
##### Retrieves all deprecated API calls
Request:
```
GET /admin/api/unstable/deprecated_api_calls.json
```

Response:
```
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"}]}
```