Carbonmark Developers
  • CARBONMARK API
    • Introduction to Carbonmark API
    • Versioning & Release Process
      • v15
      • v16
    • Quickstart
    • Explore Carbon Projects
      • Find carbon projects by country
      • Find carbon projects by vintage
      • Find carbon projects by methodology category
      • Find carbon projects by project name or description
    • Explore Index Products
      • Find index products
    • Retire Carbon
      • Postman Quickstart Guide
    • API Checkout Service (beta)
    • API Reference
  • Transfer Credits
    • Transfer Credits to/from Carbonmark
      • ICR: Import Credits to Carbonmark
      • ICR: Export Credits to ICR
      • Puro Bridge Integration Guide
  • Carbonmark Direct
    • Direct Credit Issuance
  • Resources
    • Contact us
    • Book a demo
    • Terms of Use
    • Privacy Policy
Powered by GitBook
On this page
  • Versioning and breaking changes
  • Deprecation policy
  • Canary versions
  • Upgrading
  1. CARBONMARK API

Versioning & Release Process

PreviousIntroduction to Carbonmark APINextv15

Last updated 8 months ago

Versioning and breaking changes

When consuming our API, be sure to prefix the API URL with a version number. For example, the base URL of version 1 would be v1.api.carbonmark.com.

Any changes that we make to an API version are guaranteed to be backwards compatible. However, if you omit the version prefix () your application will be exposed to breaking changes because is always routed to the latest major version.

To find the latest version of the API, visit Quickstartor view the REST reference docs at (in your web browser) with the version prefix omitted. Likewise you can find the REST reference docs for previous API versions by navigating to the base URL for that version.

Deprecation policy

When a new version of the Carbonmark API is released, we consider all previous versions to be deprecated from that date forward. We can only guarantee that a deprecated version will stay available to existing users for three months. After the three month deprecation period the version is considered retired.

Retired versions are no longer supported, and are likely to become unstable or be removed completely.

Deprecated versions will be maintained to ensure stability and availability, but they will not receive new features or major improvements.

In the future we plan to significantly extend the duration of this deprecation period, but at the moment the API is rapidly evolving to support new carbon assets and features that are not always backwards-compatible, so we have elected for a shorter 3 month deprecation period.

Canary versions

Occasionally, we will give a customer early access to a feature or improvements via unreleased “canary” or “staging” URLs.

Please note that these URLs do not include guarantees for stability, compatibility or long-term support and may become unstable within weeks or months. Users are discouraged from sharing these URLs externally, and are encouraged to migrate to the next major version as soon as it is available.

Upgrading

See individual version pages for release notes and other pertinent upgrade information.

api.carbonmark.com
api.carbonmark.com
api.carbonmark.com