Page cover image

Versions

Learn how to specify which REST API version to use whenever you make a request to the Carbonregistry.com REST API.

Specifying API version

The API is versioned using root path versioning in the format /v{version} . For example /v1/transfer .

Supported API versions

The following REST API versions are currently supported:

v0.5 -> swagger docs

v1 -> swagger docs

The following REST API versions are deprecated:

v0 -> swagger docs

About API versioning

Any breaking changes will be released in a new API version. Breaking changes are changes that can potentially break an integration. Breaking changes include:

  • removing an entire operation

  • removing or renaming a parameter

  • removing or renaming a response field

  • adding a new required parameter

  • making a previously optional parameter required

  • changing the type of a parameter or response field

  • removing enum values

  • adding a new validation rule to an existing parameter

  • changing authentication or authorization requirements

Any additive (non-breaking) changes will be available in the newest API version - they could be available in older versions but don't count on it. Additive changes are changes that should not break an integration. Additive changes include:

  • adding an operation

  • adding an optional parameter

  • adding an optional request header

  • adding a response field

  • adding a response header

  • adding enum values

When a new REST API version is released, the previous API version will be supported for at least 6 more months following the release of the new API version, and we expect our integration partners to migrate to a newer version inside this depreciation timeframe.

Last updated