---
search:
  tags:
    - offline-sync
    - GET
seo:
  description: >-
    List devices for the calling staff API token user (scope sync:read).
    Reference for the GET /api/v1/sync/devices endpoint in the Basenet Public
    API.
sidebar:
  label: List devices for the calling staff API token user (scope sync:read)
  badge: GET
title: List devices for the calling staff API token user (scope sync:read)
type: openapi-operation
---
Endpoint: `GET /api/v1/sync/devices`

Authentication: `bearerAuth` (Scoped API token (bnx\_…). Required scopes are noted per operation.)

Responses:
- `200`: Registered devices; plaintext tokens are never returned here
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `429`: Rate limited

Response 200 body (`application/json`):
- `items` (array of object, required)
- `items[].id` (string, required)
- `items[].name` (string, required)
- `items[].platform` (string or null, required)
- `items[].createdAt` (string, required)
- `items[].lastSeenAt` (string or null, required)
- `items[].revoked` (boolean, required)
- `total` (integer, required)