API v2.0

Overview

Version 2 of Mambu's REST API is in general release and should be used whenever possible.

We recommend using API v2.0 for any new feature development and to opportunistically switch over to using API v2 endpoints exclusively when making changes to existing code.

We will keep both API versions available for at least one year to allow to make appropriate adjustments in any integrations. A concrete date for decommissioning API v1 will provide you with enough time to fully migrate to v2.

API v2.0 can be used in parallel with API v1.0, as they do not conflict. You can use API v1.0 alongside API v2.0 and transition at your own pace.

Accept Header and Versioning

Request versioning is supported via the Accept header. An Accept header is required for all API v2.0 requests.

Example:

Accept: application/vnd.mambu.v2+json` or `Accept: application/vnd.mambu.v2+yaml