# bunq API

**Provider:** bunq
**Category:** maps
**Base URL:** `https://public-api.sandbox.bunq.com/{basePath}`
**Auth:** oauth2 — `Authorization: Bearer YOUR_ACCESS_TOKEN`
**Rate Limit:** 4,000 API calls/min (authenticated)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** http://bunq.com/developer

## Description

UPDATE: We have released a beta version of the new bunq API documentation.

NOTICE:  *We have updated the sandbox base url to https://public-api.sandbox.bunq.com/v1/. Please update your applications accordingly. Check here: <https://github.com/bunq/sdk_ph

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://public-api.sandbox.bunq.com/{basePath}/attachment-public` | Create a new public attachment. Create a POST request with a payload that contai |
| GET | `https://public-api.sandbox.bunq.com/{basePath}/attachment-public/{attachment-publicUUID}/content` | Get the raw content of a specific attachment. |
| GET | `https://public-api.sandbox.bunq.com/{basePath}/attachment-public/{itemId}` | Get a specific attachment's metadata through its UUID. The Content-Type header o |
| POST | `https://public-api.sandbox.bunq.com/{basePath}/avatar` | Avatars are public images used to represent you or your company. Avatars are use |
| GET | `https://public-api.sandbox.bunq.com/{basePath}/avatar/{itemId}` | Avatars are public images used to represent you or your company. Avatars are use |
| GET | `https://public-api.sandbox.bunq.com/{basePath}/device` | Get a collection of Devices. A Device is either a DevicePhone or a DeviceServer. |
| GET | `https://public-api.sandbox.bunq.com/{basePath}/device-server` | Get a collection of all the DeviceServers you have created. |
| POST | `https://public-api.sandbox.bunq.com/{basePath}/device-server` | Create a new DeviceServer providing the installation token in the header and sig |

## Authentication

OAuth 2.0 or JWT (Server Authentication) for machine-to-machine

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

## Sample Request

```bash
curl -X GET 'https://public-api.sandbox.bunq.com/{basePath}/attachment-public' \
  -H '# No auth required'
```

## Sample Response

```json
{}
```

## Pricing Details

Individual: free (10GB). Business Starter: $15/user/mo (unlimited storage). Business: $20/user/mo. Enterprise: custom.

---

*Source: [API Map](https://apimap.dev/apis/bunq/) — CC BY 4.0*