GuideLab API
Files

List files

Returns a paginated list of files for the current organization. Labs see all files; clinics see only their own. Supports filtering by patient, clinic, file type, and unassigned status.

GET
/files

Returns a paginated list of files for the current organization. Labs see all files; clinics see only their own. Supports filtering by patient, clinic, file type, and unassigned status.

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 <= 10000
Default1
limit?integer

Items per page

Range1 <= value <= 100
Default20
patientId?string

Filter by patient ID

clinicId?string

Filter by clinic ID (lab only)

type?string

Filter by file type: scan, photo, prescription, xray, other

unassigned?||

Show only files not attached to an order

Defaultfalse
search?string

Search by file name

Response Body

application/json

curl -X GET "https://example.com/files"
{  "data": [    {      "id": "string",      "partnershipId": "string",      "uploadedByOrganizationId": "string",      "name": "string",      "type": "string",      "mimeType": "string",      "size": 0,      "url": "string",      "thumbnailUrl": "string",      "patientId": "string",      "patientName": "string",      "orderId": "string",      "orderDisplayId": "string",      "orderStatus": "string",      "uploadedBy": "string",      "createdAt": "string"    }  ],  "pagination": {    "page": 0,    "limit": 0,    "total": 0,    "totalPages": 0  }}
Empty
Empty

Finalize a direct file upload POST

Confirms that a previously presigned upload completed successfully, validates the stored object metadata and size, and then creates the file DB record.

Get presigned upload URL POST

Generates a presigned PUT URL so the client can upload directly to storage. No file DB row is created until the client calls finalize after a successful upload. Optionally returns a second signed PUT URL for a thumbnail. Valid for 5 minutes.