---
schema_version: "1"
id: e67d18036fbe31bf1490c120019791d2f64214c1832686d5d27699e8adafacab
title: API End-of-Life Policy
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_tooling/tooling_api_eol.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/tooling_api_eol.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 3adc7f7ce7e867557e916777d7d77e1a90b8b6dd3949eb38a4eed4d0ab52984a
description: See which Tooling REST and SOAP API versions are supported, unsupported, or unavailable.
---
# API End-of-Life Policy

See which Tooling REST and SOAP API versions are supported, unsupported, or unavailable.

Salesforce is committed to supporting each API version for a minimum of 3 years from the date of first release. To improve the quality and performance of the API, versions that are over 3 years old sometimes are no longer supported.

Salesforce notifies customers who use an API version scheduled for deprecation at least 1 year before support for the version ends.

<table class="featureTable sort_table" summary="">



        <thead class="thead sorted" align="left">
          <tr>
            <th class="featureTableHeader  " id="d11421e55">Salesforce API Versions</th>

            <th class="featureTableHeader  " id="d11421e58">Version Support Status</th>

            <th class="featureTableHeader  " id="d11421e61">Version Retirement Info</th>

          </tr>

        </thead>

        <tbody class="tbody">
          <tr>
            <td class="entry" headers="d11421e55" data-title="Salesforce API Versions">Versions 41.0 through <span class="ph">66.0</span>
            </td>

            <td class="entry" headers="d11421e58" data-title="Version Support Status">Supported.</td>

            <td class="entry" headers="d11421e61" data-title="Version Retirement Info"></td>

          </tr>

          <tr>
            <td class="entry" headers="d11421e55" data-title="Salesforce API Versions">Versions 31.0 through 40.0</td>

            <td class="entry" headers="d11421e58" data-title="Version Support Status">
              <p class="p">Supported.</p>
              <p class="p">Deprecated and unsupported from Summer ’27.</p>
              <p class="p">Retired
                from Summer ’28.</p>
            </td>

            <td class="entry" headers="d11421e61" data-title="Version Retirement Info"><a class="xref" href="https://help.salesforce.com/s/articleView?id=005321531&amp;type=1&amp;language=en_US" target="_blank">Salesforce Platform API Versions 31.0
                through 40.0 Retirement</a></td>

          </tr>

          <tr>
            <td class="entry" headers="d11421e55" data-title="Salesforce API Versions">Versions 21.0 through 30.0</td>

            <td class="entry" headers="d11421e58" data-title="Version Support Status">As of Summer ’25, these versions are retired and unavailable.</td>

            <td class="entry" headers="d11421e61" data-title="Version Retirement Info"><a class="xref" href="https://help.salesforce.com/s/articleView?id=000389618&amp;type=1&amp;language=en_US" target="_blank">Salesforce Platform API Versions 21.0
                through 30.0 Retirement</a></td>

          </tr>

          <tr>
            <td class="entry" headers="d11421e55" data-title="Salesforce API Versions">Versions 7.0 through 20.0</td>

            <td class="entry" headers="d11421e58" data-title="Version Support Status">As of Summer ’22, these versions are retired and unavailable.</td>

            <td class="entry" headers="d11421e61" data-title="Version Retirement Info"><a class="xref" href="https://help.salesforce.com/s/articleView?id=000380623&amp;type=1&amp;language=en_US" target="_blank">Salesforce Platform API Versions 7.0
                through 20.0 Retirement</a></td>

          </tr>

        </tbody>

      </table>

If you request any resource or use an operation from a retired API version, REST API returns the 410:GONE error code.

If you request any resource or use an operation from a retired API version, SOAP API returns 500:UNSUPPORTED\_API\_VERSION error code.

To identify requests made from old or unsupported API versions, use the [API Total Usage](https://developer.salesforce.com/docs/atlas.en-us.264.0.object_reference.meta/object_reference/sforce_api_objects_eventlogfile_apitotalusage.htm) event type.