Hey bunqers 🌈,

Find everything you need to start automating your banking and integrating your apps with our open API, and make life even easier with bunq Developer!

What’s bunq Developer?

bunq Developer is an opportunity to create, test and use your own apps with the help of bunq API.

What are the functionalities of bunq Developer?

• Multiple apps: Create personal and business apps. Find API credentials and start using them in seconds.

• Easy testing: Create test users with just one click, and find all test-user information, including login codes, in no time.

• QR code login: Log in by scanning a QR code with your bunq app.

How can I manage my API keys?

1. Tap on your Profile in the top left corner

2. Tap on ⚙️ Settings

3. Scroll down and tap “Developers”

4. Tap API Keys

5. Follow the instructions in the app

Who can use bunq Developers?

bunq Developers is available for our bunq Pro and bunq Elite users with Personal or Business accounts.

bunq Developer FAQs

Looking forward to trying it out, but still wondering how it works? Check out some of our frequently asked questions below 👇

• What can I do with the bunq API?
  You can integrate your bunq account with any features you like, and build a custom flow designed specifically to make your life easier. Find the full API reference here

  
  
  

• Can I use my PSD2 certificate with the production API key generated by bunq Developer?
  No. PSD2-licensed parties must follow a dedicated flow. You’ll find more information about it on this link

  
  
  

• I didn’t use my API key after creating the app and now it’s expired. How do I make it work again?
  With security in mind, you have 1 hour to activate the API keys after you create the app. If you wait more than that, you’ll need to create a new app with a new API key.

  
  
  

• How do I find the API credentials?
  Just create an app, open its settings and you’ll find them in the Authentication tab.

  
  
  

• “You can have at most 1 pending first use credential.” What does this mean?
  You need to activate the API key of the previously created app first. It expires if you
  don’t use it after 1 hour.

I’m getting an error from the bunq API. What should I do?

Start by looking up the error code and error_description from your response in our API documentation. Most errors are documented there with a fix. Check status.bunq.com for ongoing incidents too.

If the documentation doesn’t explain the error, or you think the bug is on our side, report it to apipartner@bunq.com.

How do I report an API error?

Email apipartner@bunq.com with the response ID, the error and the timestamp. We use these three to find your request in our logs, so we can’t investigate a report that’s missing any of them.

These help us find the cause faster:

• Endpoint and method, for example POST /v1/user/{id}/monetary-account/{id}/payment

• Request ID (the X-Bunq-Client-Request-Id header you sent)

• Environment: production or sandbox

• Your integration’s name and version, if you build for other bunq users

• Expected vs. actual behavior, in one or two sentences

Never send API keys, private keys, session tokens or full account details. If we need more, we’ll ask through a secure channel.

Example report

Environment: Production
Endpoint: POST /v1/user/12345/monetary-account/67890/payment
Timestamp: 20261016 1432 UTC
Response ID: 8f3c2a10-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Error: 400, {"Error":[{"error_description":"..."}]}
Expected: payment is created. Actual: 400 error on every request since 20261015, with an unchanged request body.

What happens after I report it?

We look up your request using the response ID and timestamp. If it’s a bug on our side, we fix it and let you know. If the cause is in your request, we show you what to change and update the documentation where it was unclear.

We support issues with the bunq API itself. We can’t debug your own code or infrastructure beyond what our logs show.

Want to create your first app in bunq Developer?

Just follow this link 🌈

Need further help?

If you have further questions regarding bookkeeping integrations, feel free to reach us at apipartner@bunq.com.