API LifeCycle
API versions are released when new functionality, schema changes, or bug fixes demand breaking changes to an endpoint.
We recommend everyone use API versions that are considered “stable“ if you don't need the latest functionality. It is advised to update your integrations to a new API version whenever you need new functionality, or whenever the API falls in the end-of-life status.
We keep supporting all API versions until the end of life has been announced. End of life is typically reached 3 months after a new stable release is available.
API Endpoints and Status
Endpoint | Version | API Release date | Status |
---|---|---|---|
Get Invoices | v1 | November 2023 | Experimental |
Get Example Invoices | v1 | November 2023 | Experimental |
Get Customer Specifications | v1 | January 2024 | Experimental |
Get Customer Subscriptions | v1 | February 2024 | Experimental |
Get Products | v1 | April 2024 | Experimental |
Status explanation
Status | Description | Support | Bugfix Releases | Feature Additions |
---|---|---|---|---|
Experimental | API release that is currently under development. You can already use the latest features and fixes, but API might have breaking changes implemented without notice. These APIs are published to collect user feedback and to measure API performance. It allows early adopters to discover the latest functionality. | Yes | Yes | Yes |
Stable | This API version is considered “stable“ and is fully supported and maintained with bug fixes when needed. Not all bug fixes can be deployed to stable APIs if a change breaks existing logic. No new functionality will be released to APIs in this status. | Yes | sometimes | No |
End of Life | This API status is no longer supported, not maintained, and will be shut down soon. We recommend everyone to upgrade to a new API version. | No | No | No |
Did you find an issue, or require functionality that is not listed in the above table? Please contact our support team or submit feedback via https://feedback.copaco.cloud.