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.
| Salesforce API Versions | Version Support Status | Version Retirement Info |
|---|---|---|
| Versions 41.0 through 68.0 | Supported. | |
| Versions 31.0 through 40.0 |
| Salesforce Platform API Versions 31.0 through 40.0 Retirement |
| Versions 21.0 through 30.0 | As of Summer ’25, these versions are retired and unavailable. | Salesforce Platform API Versions 21.0 through 30.0 Retirement |
| Versions 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 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 event type.
j
