For the complete documentation index, see llms.txt. This page is also available as Markdown.

Use the Access Token to get a user session

Once you have received the access_token through the OAuth flow, you must use it to create a session. This session allows your app to perform authenticated API calls on behalf of the user. This is an equal process to the regular flow. However what is different is that you use the end-users access token to get the session.

Endpoint

POST /v1/session-server

Purpose

This endpoint creates a new API session using the OAuth access token.

Example cURL Request

⚠️ This example assumes you've already signed the payload and have the device token ready.

curl -X POST https://api.bunq.com/v1/session-server \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "User-Agent: my-app-name" \
  -H "X-Bunq-Language: en_US" \
  -H "X-Bunq-Region: nl_NL" \
  -H "X-Bunq-Geolocation: 0 0 0 0 000" \
  -H "X-Bunq-Client-Authentication: your_device_token" \
  -H "X-Bunq-Client-Signature: BASE64_SIGNATURE_OF_PAYLOAD" \
  -d '{"secret":"USER_ACCESS_TOKEN"}'

✅ Example Response


Last updated

Was this helpful?