Deprecation Calendar
As we continue to advance our APIs, we introduce new endpoint versions with improved features and methodologies. When a newer version is available, older versions are deprecated and eventually removed.
Here you can find all of the API endpoints and related versions that are planned for deprecation:
| API Endpoint | Version to be deprecated | Deprecation date | Migrate to | Migration guide |
|---|---|---|---|---|
| Energy | v1 | 31st July 2026 | v1.3 | Energy v1.3 release notes |
| v1.1 | 30th November 2026 | v1.3 | Energy v1.3 release notes | |
| v1.2 | 31st March 2027 | v1.3 | Energy v1.3 release notes | |
| Freight | v2 | 30th September 2026 | v3 | Freight v3 release notes |
| Cloud Computing | v1 | 30th September 2026 | - | - |
| Custom Mappings | v1 | 31st December 2026 | - | - |
Benefits of trying Climatiq’s preview endpoints
Preview endpoints give you early access to new features, updated emission factors, and methodology improvements before they reach General Availability (GA). This allows you to:
- Evaluate upcoming changes and plan your integration timeline ahead of GA release
- Test new capabilities in a non-production environment before committing to a migration
- Work with the most current emission factors and calculation methodologies available
- Provide feedback that can shape the final API design before it is locked in
Preview endpoints are versioned and run in parallel with GA endpoints, so you can adopt them at your own pace without disrupting existing integrations. The deprecation window is 3 months after the release of a newer version.
Benefits of transitioning to Climatiq’s Generally Available (GA) endpoints
GA endpoints are production-ready and designed for long-term use. When you migrate from a preview version to a stable one, you benefit from:
- A minimum one-year deprecation window before any breaking changes, giving your team time to plan migrations without urgency
- Validated methodology - GA endpoints are typically audited for compliance with relevant standards such as ISO 14067, GHG Protocol, GLEC, and ISO 14083
- Full documentation, support coverage, and guaranteed backward compatibility within the major version
- Confidence that your calculations meet the requirements of regulatory and disclosure frameworks such as CSRD