GuideLab API
Patients

Paginated patient list

Retrieve a paginated list of patients with order counts. Labs see patients from partnered clinics (respecting share-all-patients and lab access settings). Clinics see only their own. Supports search, sorting, and clinic filtering.

GET
/patients/list

Retrieve a paginated list of patients with order counts. Labs see patients from partnered clinics (respecting share-all-patients and lab access settings). Clinics see only their own. Supports search, sorting, and clinic filtering.

Authorization

__Secure-guidelab-prod.session_token<token>

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

In: cookie

Query Parameters

page?integer

Page number

Range1 <= value
Default1
limit?integer

Items per page

Range1 <= value <= 100
Default20
search?string

Search term for patient name or external ID

clinicId?string

Filter by clinic ID

sortBy?string

Field to sort by

Default"name"

Value in

  • "name"
  • "practice"
  • "dateOfBirth"
  • "orders"
  • "createdAt"
sortOrder?string

Sort direction

Default"asc"

Value in

  • "asc"
  • "desc"

Response Body

application/json

curl -X GET "https://example.com/patients/list"
{  "data": [    {      "id": "string",      "firstName": "string",      "lastName": "string",      "fullName": "string",      "dateOfBirth": "string",      "phone": "string",      "email": "string",      "externalId": "string",      "clinicId": "string",      "clinicName": "string",      "orderCount": 0,      "createdAt": "string",      "patientCode": "string",      "isAnonymized": true    }  ],  "pagination": {    "page": 0,    "limit": 0,    "total": 0,    "totalPages": 0  }}
Empty
Empty
Empty

List labs with access to a patient GET

List labs with effective access through either an explicit live grant or the active partnership's share-all-patients policy. Clinic only - the patient must belong to the current clinic.

Revoke lab access to a patient DELETE

Revoke a lab's effective access while retaining grant and revocation audit evidence. Under partnership-wide sharing this creates a per-patient exclusion. Active and suspended partnership epochs are supported. Clinic only.