GuideLab API
Patients

Search patients (autocomplete / combobox)

Search patients with fuzzy matching for autocomplete/combobox use. Labs see patients from partnered clinics (respecting share-all-patients and lab access settings). Clinics see only their own patients. Anonymized patients are masked for labs.

GET
/patients

Search patients with fuzzy matching for autocomplete/combobox use. Labs see patients from partnered clinics (respecting share-all-patients and lab access settings). Clinics see only their own patients. Anonymized patients are masked for labs.

Authorization

__Secure-guidelab-prod.session_token<token>

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

In: cookie

Query Parameters

q?string

Search query for patient name, code, or external ID

Default""
clinicId?string

Filter patients by clinic ID

limit?integer

Maximum number of results to return

Range0 < value <= 100
Default50

Response Body

application/json

curl -X GET "https://example.com/patients"
{  "patients": [    {      "id": "string",      "clinicId": "string",      "firstName": "string",      "lastName": "string",      "gender": "string",      "dateOfBirth": "string",      "phone": "string",      "email": "string",      "externalId": "string",      "clinicName": "string",      "patientCode": "string",      "fullName": "string",      "clinic": {        "id": "string",        "name": "string"      },      "isAnonymized": true    }  ]}
Empty
Empty
Empty
Empty

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.

Update a patient's details PUT

Update an existing patient's details. Clinics can only update their own patients. Labs can update patients from partnered clinics they have access to (subject to lab access and share-all-patients settings). Anonymized/hidden patients cannot be edited. The patient's clinic and patient code cannot be changed.