See which REST 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.
<sfdocstbl><table>
<col> </col> <col> </col> <col> </col> <thead> <tr> <th> Salesforce API Versions </th> <th> Version Support Status </th> <th> Version Retirement Info </th> </tr> </thead> <tbody> <tr> <td> Versions 41.0 through 67.0 </td> <td> Supported. </td> <td> </td> </tr> <tr> <td> Versions 31.0 through 40.0 </td> <td> <p> Supported. </p> <p> Deprecated and unsupported from Summer ’27. </p> <p> Retired from Summer ’28. </p> </td> <td> <a href="https://help.salesforce.com/s/articleView?id=005321531&type=1">Salesforce Platform API Versions 31.0 through 40.0 Retirement</a> </td> </tr> <tr> <td> Versions 21.0 through 30.0 </td> <td> As of Summer ’25, these versions are retired and unavailable. </td> <td> <a href="https://help.salesforce.com/s/articleView?id=000389618&type=1">Salesforce Platform API Versions 21.0 through 30.0 Retirement</a> </td> </tr> <tr> <td> Versions 7.0 through 20.0 </td> <td> As of Summer ’22, these versions are retired and unavailable. </td> <td> <a href="https://help.salesforce.com/s/articleView?id=000380623&type=1">Salesforce Platform API Versions 7.0 through 20.0 Retirement</a> </td> </tr> </tbody> </table></sfdocstbl>If you request any resource or use an operation from a retired API version, REST API returns the 410:GONE error code.
To identify requests made from old or unsupported API versions, use the API Total Usage event type.