GuideLab API
Conversations

List conversations

Retrieve paginated conversations for the current organization. Supports filtering by all/unread/waiting/responded and text search across partner names and message previews. Available to both labs and clinics.

GET
/conversations

Retrieve paginated conversations for the current organization. Supports filtering by all/unread/waiting/responded and text search across partner names and message previews. Available to both labs and clinics.

Authorization

__Secure-guidelab-prod.session_token<token>

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

In: cookie

Query Parameters

filter?string

Value in

  • "all"
  • "unread"
  • "waiting"
  • "responded"
search?string
limit?string
offset?string

Response Body

application/json

curl -X GET "https://example.com/conversations"
{  "data": [    {      "id": "string",      "partnershipId": "string",      "orderId": "string",      "title": "string",      "lastMessageId": "string",      "lastMessageAt": "string",      "lastMessagePreview": "string",      "lastMessageSenderId": "string",      "unreadCounts": {        "property1": 0,        "property2": 0      },      "createdAt": "string",      "updatedAt": "string",      "partner": {        "id": "string",        "name": "string",        "nameMissing": true,        "logo": "string"      },      "order": {        "id": "string",        "orderNumber": "string",        "status": "string",        "patientId": "string",        "hidePatientFromLab": true      },      "patient": {        "id": "string",        "firstName": "string",        "lastName": "string",        "patientCode": "string"      },      "lastMessageSender": {        "id": "string",        "name": "string",        "image": "string"      }    }  ],  "totalUnread": 0,  "pagination": {    "total": 0,    "limit": 0,    "offset": 0,    "hasMore": true  }}
Empty
Empty

List messages in a conversation GET

Retrieve paginated messages for a conversation with sender info, org details, and attachments. Internal notes are only visible to the org that sent them. Supports cursor-based pagination via before/after message IDs.

Mark conversation as read POST

Advance the current organization's conversation read cursor to the latest committed message sequence. Broadcasts the organization-wide cursor to connected clients.