The current version of the API and documentation is built for the latest API version V4. If you use an older version of this API, some endpoints or fields might be missing. New API versions are released when new functionality or bugfixes demands breaking changes to an endpoint.

We recommend everyone use API versions that are considered “under maintenance“. It is advised to update your integrations to the latest API release whenever you need new functionality, or whenever the API falls outside of the maintenance status.

We keep supporting all API versions until the last customer has moved away to new API releases. However, we only deliver bug fixes with the N-1 principle. This means that you can always count on our support with API questions and found issues, but you might be instructed to move your application to a new API version that is still under maintenance in case a bug is found in an End of Maintenance API version.

New API functionality that will be developed on request will only be released in the latest API endpoint version or split to a new API endpoint in case of breaking changes.

Release notes


Bugfix release

We have released a hotfix for the Billing API that affected v4 endpoints “invoices”, “customerinvoices”, and “consolidatedinvoices”.

Fixed Issue(s)

  • CD-204 - Billing API "Invoice" endpoint v4 has duplicated line items due to "resource rate periods"


Billing API Versions

API Version

API Release Date

Status

Notes

v4

Current Version

API extended with ResourceRatePeriod info for the Microsoft NCE billing model and PO numbers.

v3

Maintenance

v2

End of Maintenance

API extended with new endpoints for customer invoices and subscriptionsdetails

v1

End of Life

Initial release, no longer active

Status explanation

Status

Description

Support

BugFix releases

Feature Additions

Current Verion

Latest API release that is fully supported, gets new features implemented to it(as long as they don't break logic) and will get bugfixes first.

Yes

Yes

Yes

Maintenance

The API is fully supported and maintained with bugfixes when needed.

Yes

Yes

No

End of Maintenance

The API is supported, but no new development will take place if bugs are discovered.

Yes

No

No

End of Life

The API is no longer supported, not maintained and can be shutdown at any time

No

No

No