API End-of-Life
Salesforce is committed to supporting each API version for a minimum of three years from the date of first release. In order to mature and improve the quality and performance of the API, versions that are more than three years old might cease to be supported.
When an API version is to be deprecated, advance notice is given at least one year before support ends. Salesforce will directly notify customers using API versions planned for deprecation.
| Salesforce API Versions | Version Support Status | Version Retirement Info |
|---|---|---|
| 31.0 through 59.0 | Supported | |
| 21.0 through 30.0 | As of Summer ‘22, these versions have been deprecated and are no longer supported by Salesforce. Starting Summer ’25, these versions will be retired and unavailable. | Salesforce Platform API Versions 21.0 through 30.0 Retirement |
| 7.0 through 20.0 | As of Summer ‘22, these versions are retired and unavailable. | Salesforce Platform API Versions 7.0 through 20.0 Retirement |
If you request any resource or use an operation from a retired API version, REST API returns the error code 410:GONE.
To identify requests made from old or unsupported API versions, access the free API Total Usage event type.