GuideLab API
Scanner Connections

Get Scanner Connection

Retrieve a single scanner connection by ID, including scanner-type-specific metadata (e.g. Medit group info).

GET
/scanner-connections/{id}

Retrieve a single scanner connection by ID, including scanner-type-specific metadata (e.g. Medit group info).

Authorization

__Secure-guidelab-prod.session_token<token>

Production session cookie set for the guidelab.co domain by Better Auth

In: cookie

Path Parameters

id*string

Response Body

application/json

curl -X GET "https://example.com/scanner-connections/550e8400-e29b-41d4-a716-446655440000"
{  "connection": {    "id": "string",    "organizationId": "string",    "scannerType": "string",    "name": "string",    "connectionStatus": "string",    "statusMessage": "string",    "testMode": true,    "sortOrder": 0,    "isActive": true,    "createdAt": "string",    "updatedAt": "string",    "lastConnectedAt": "string",    "lastSyncAt": "string",    "meditGroupName": "string",    "meditGroupType": "string"  }}
Empty
Empty

Disconnect Scanner Connection POST

Disconnect a scanner connection by removing stored tokens and scanner-specific data. For iTero, attempts to unpair the account first. Resets connection status to disconnected.

Get Scanner Connection Case GET

Operationally retrieve detailed information about a specific scanner case/order. Provider access may idempotently refresh an expired token and record connection health; this endpoint is not a tenant-settings inspection read. Supports Medit, 3Shape (searches all active regions), and iTero scanners.