The bunq API is based on the RESTful principles. It returns responses in the JSON format. The only exclusion is binary (image) files.
{% hint style="info" %} PSD2 NOTICE: The second Payment Services Directive (PSD2) may affect your current or planned usage of our public API, as some of the API services are now subject to a permit. Please be aware that using our public API without the required PSD2 permit is at your own risk. Take notice of our updated API Terms and Conditions for more information. {% endhint %}
- Create a user account with your phone. Afterwards, you can use this account to create an API key from which you can make API calls. You can find API key management under Profile → Security & Settings → Developers → API keys.
- Register a device. A device can be a phone (private), computer or a server (public). You can register a new device by using the installation and device-server calls.
- Open a session. Sessions are temporary and expire in the same amount of time you have set for auto logout in your user account.
- Make your first call!
{% hint style="info" %} Looking to start with the sandbox environment first? Jump to the Sandbox page. {% endhint %}
Developments in the financial sector, changing regulatory regimes and new feature requests require us to be flexible. This means we can iterate quickly to improve the API and related tooling. This also allows us to quickly process your feedback (which we are happy to receive!). Therefore, we have chosen not to attach any version numbers to the changes just yet. We will inform you in a timely manner of any important changes we make before they are deployed on together.bunq.com.
Once the speed of iteration slows down and more developers start using the API and its sandbox we will start versioning the API using the version number in the HTTP URLs (i.e. the v1/ part of the path). We will inform you when this happens.