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

See which Metadata 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="d41957e54">Salesforce API Versions</th>

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

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

          </tr>

        </thead>

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

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

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

          </tr>

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

            <td class="entry" headers="d41957e57" 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="d41957e60" 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="d41957e54" data-title="Salesforce API Versions">Versions 21.0 through 30.0</td>

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

            <td class="entry" headers="d41957e60" 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="d41957e54" data-title="Salesforce API Versions">Versions 7.0 through 20.0</td>

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

            <td class="entry" headers="d41957e60" 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.