Bunq Device API

Bunq Device API is a tool that allows developers to access and interact with Bunq's financial services on various devices, such as smartphones, tablets, and computers. With this API, developers can create applications that enable users to manage their money, make payments, transfer funds, and more, all from the convenience of their preferred device.

OpenAPI Specification

bunq-device--openapi-original.yml Raw ↑
openapi: 3.0.0
info:
  title: 'Bunq device/'
  description: Needs description.
  termsOfService: http://bunq.com/terms-api/
  contact:
    name: bunq Developer Support
    url: http://bunq.com/developer
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: '1.0'
servers:
  - url: https://public-api.sandbox.bunq.com/{basePath}
    description: Sandbox server
    variables:
      basePath:
        default: v1
  - url: https://api.bunq.com/{basePath}
    description: Production server
    variables:
      basePath:
        default: v1
components:
  schemas:
    DeviceRead:
      type: object
      properties:
        DeviceServer:
          type: object
          description: ''
          readOnly: true
          writeOnly: false
          $ref: '#/components/schemas/DeviceServer'
paths:
  /device/{itemId}:
    get:
      tags:
        - Device
      summary: ''
      operationId: READ_Device
      description: Get a single Device. A Device is either a DevicePhone or a DeviceServer.
      parameters:
        - in: path
          name: itemId
          description: ''
          required: true
          schema:
            type: integer
        - $ref: '#/components/parameters/Cache-Control'
        - $ref: '#/components/parameters/User-Agent'
        - $ref: '#/components/parameters/X-Bunq-Language'
        - $ref: '#/components/parameters/X-Bunq-Region'
        - $ref: '#/components/parameters/X-Bunq-Client-Request-Id'
        - $ref: '#/components/parameters/X-Bunq-Geolocation'
        - $ref: '#/components/parameters/X-Bunq-Client-Authentication'
      responses:
        '200':
          description: >-
            Used to get a Device or a listing of Devices. Creating a
            DeviceServer should happen via /device-server
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeviceRead'
          headers:
            X-Bunq-Client-Response-Id:
              $ref: '#/components/headers/X-Bunq-Client-Response-Id'
            X-Bunq-Client-Request-Id:
              $ref: '#/components/headers/X-Bunq-Client-Request-Id'
            X-Bunq-Server-Signature:
              $ref: '#/components/headers/X-Bunq-Server-Signature'
        '400':
          $ref: '#/components/responses/GenericError'
tags:
  - name: Device