GuideLab API
Partnerships

List partnerships for the current organization

Retrieve a paginated list of partnerships with order statistics. Labs see clinic partners, clinics see lab partners. Supports search, status filtering, practice group filtering, and configurable sorting. Available to both labs and clinics.

GET
/partnerships

Retrieve a paginated list of partnerships with order statistics. Labs see clinic partners, clinics see lab partners. Supports search, status filtering, practice group filtering, and configurable sorting. 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

page?integer

Page number

Range1 <= value
Default1
limit?integer

Items per page

Range1 <= value <= 100
Default20
search?string

Search term for partner name, email, or city

status?|

Filter by partnership status

Default"all"
practiceGroupId?string

Filter by practice group ID

sortBy?string

Field to sort by

Default"name"

Value in

  • "name"
  • "totalOrders"
  • "activeOrders"
  • "lastOrderDate"
  • "createdAt"
sortOrder?string

Sort direction

Default"asc"

Value in

  • "asc"
  • "desc"

Response Body

application/json

curl -X GET "https://example.com/partnerships"
{  "data": [    {      "id": "string",      "partnerId": "string",      "partnerName": "string",      "partnerEmail": "string",      "partnerPhone": "string",      "partnerCity": "string",      "partnerLogo": "string",      "status": "string",      "initiatedBy": "string",      "totalOrders": 0,      "activeOrders": 0,      "lastOrderDate": "string",      "practiceGroupId": "string",      "practiceGroupName": "string",      "billingOwnerId": "string",      "partnerProvisioningStatus": "claimed",      "claimKind": "provisional_owner",      "createdAt": "string"    }  ],  "pagination": {    "page": 0,    "limit": 0,    "total": 0,    "totalPages": 0  }}
Empty
Empty
Empty

Invite an owner to claim a lab-managed clinic POST

Starts an ownership handoff for an imported clinic while preserving its existing active partnership and history.

Reactivate a suspended partnership POST

Reactivate a suspended partnership back to active status. Either party in the partnership can reactivate it. Sends a notification to the other party. Available to both labs and clinics.