> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plaud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Device Binding

> Returns the remote binding state of a device along with every client ID it has previously been bound to, including bindings made in other apps.

Use this endpoint to check device state remotely, and to drive [Device Recovery](/plaud-embedded/ios-sdk#device-recovery) when the cloud and local bind state go out of sync and the device locks. Recovery only applies when `is_bind` is **not** `true`; if `is_bind` is `true` the device is owned by another account and that owner must unbind it first.



## OpenAPI

````yaml /openapi/binding.json get /open/partner/sdk/binding
openapi: 3.0.4
info:
  title: Device Binding APIs
  description: >-
    APIs that track device state remotely. Binding a Plaud device involves two
    steps:

    1. **Cloud bind**: registers the device/owner association in the Plaud
    registry so you can track Connected Device state remotely

    2. **Local device bind**: triggered over BLE by the Embedded SDK, which
    verifies and generates the key pair on-device
  version: 0.0.1
servers:
  - url: https://platform-us.plaud.ai/developer/api
    description: US partner endpoint
  - url: https://platform-jp.plaud.ai/developer/api
    description: Japan partner endpoint
security:
  - bearerAuth: []
paths:
  /open/partner/sdk/binding:
    get:
      tags:
        - Device Binding API
      summary: Get Device Binding
      description: >-
        Returns the remote binding state of a device along with every client ID
        it has previously been bound to, including bindings made in other apps.


        Use this endpoint to check device state remotely, and to drive [Device
        Recovery](/plaud-embedded/ios-sdk#device-recovery) when the cloud and
        local bind state go out of sync and the device locks. Recovery only
        applies when `is_bind` is **not** `true`; if `is_bind` is `true` the
        device is owned by another account and that owner must unbind it first.
      operationId: getDeviceBinding
      parameters:
        - in: query
          name: type
          required: true
          description: >-
            Device type string derived from the SN prefix (`881` → `notepro`,
            `882` → `notepins`).
          schema:
            type: string
            example: notepro
        - in: query
          name: sn
          required: true
          description: Device serial number.
          schema:
            type: string
            example: '8810000000000001'
      responses:
        '200':
          description: Current binding state and bind history for the device
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BindingResponse'
              example:
                is_bind: false
                bind_history:
                  - b7c1f0a2-4d5e-4a3b-9c8d-1e2f3a4b5c6d
                  - 3f9e8d7c-6b5a-4938-8271-0a1b2c3d4e5f
        '404':
          description: >-
            Unknown device — an unknown serial number returns a bare `404` with
            no error body.
components:
  schemas:
    BindingResponse:
      type: object
      properties:
        is_bind:
          type: boolean
          nullable: true
          description: >-
            Three-state remote binding flag. `true` = bound to another account
            (stop — recovery is not possible), `false` = unbound, `null` =
            signed but never bound. Run Device Recovery only when this is
            **not** `true`.
          example: false
        bind_history:
          type: array
          description: >-
            Previously bound client IDs, newest first. One entry is recorded
            **per bind event**, so the same client ID can appear more than once
            — de-duplicate before using it for Device Recovery.
          items:
            type: string
          example:
            - b7c1f0a2-4d5e-4a3b-9c8d-1e2f3a4b5c6d
            - 3f9e8d7c-6b5a-4938-8271-0a1b2c3d4e5f
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication using a **User Token**. See the [Authentication
        API reference](/plaud-embedded/auth-api-overview) for how to mint one.

````