---
search:
  tags:
    - offline-sync
    - GET
seo:
  description: >-
    Bootstrap an offline-sync device session (device bearer token). Reference
    for the GET /api/v1/sync/bootstrap endpoint in the Basenet Public API.
sidebar:
  label: Bootstrap an offline-sync device session (device bearer token)
  badge: GET
title: Bootstrap an offline-sync device session (device bearer token)
type: openapi-operation
---
Endpoint: `GET /api/v1/sync/bootstrap`

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

Responses:
- `200`: Device, actor, visible matters, and selected contract version
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `429`: Rate limited

Response 200 body (`application/json`):
- `contractVersion` (one of `"v1"`, required)
- `device` (object, required)
- `device.id` (string, required)
- `device.name` (string, required)
- `device.platform` (string or null, required)
- `user` (object, required)
- `user.id` (string, required)
- `matters` (array of object, required)
- `matters[].id` (string, required)
- `matters[].number` (string, required)
- `matters[].name` (string, required)
- `matters[].status` (string, required)
- `matters[].subscribed` (boolean, required)
- `matters[].enabled` (boolean, required)
