API Versioning & Deprecation

Current Version

The bunq API is currently at version 1. All API endpoints are prefixed with /v1/:

https://api.bunq.com/v1/user
https://api.bunq.com/v1/user/{userId}/monetary-account

There are no plans for a version 2. The /v1/ prefix will remain stable.

Backwards Compatibility

bunq aims to maintain backwards compatibility within v1. We may add new fields to responses and new optional parameters to requests without a version bump. We will not remove or rename existing fields without a deprecation notice.

Deprecated Endpoints

Endpoints that are no longer recommended are marked [deprecated] in the API Reference. Deprecated endpoints continue to function but may be removed in a future update.

We aim to communicate deprecations in the API documentation. If you are relying on a deprecated endpoint, migrate to the recommended alternative as documented on that endpoint's page.

Staying Up to Date

• Watch the bunq developer documentation for updates to endpoint pages

• Check the API Reference for [deprecated] tags on endpoints you use

• Contact the API support team if you have questions about a specific endpoint's roadmap