GuideLab API
Partnerships

Search for potential partners

Search for discoverable organizations to form new partnerships with. Excludes existing partners. Supports text search, organization type filtering, and geographic bounding box filtering. Available to both labs and clinics.

GET
/partnerships/search

Search for discoverable organizations to form new partnerships with. Excludes existing partners. Supports text search, organization type filtering, and geographic bounding box filtering. 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

q?string

Search query for organization name

type*string

Organization type to search for

Value in

  • "lab"
  • "clinic"
minLat?number

Minimum latitude for geographic bounding box

Range-90 <= value <= 90
maxLat?number

Maximum latitude for geographic bounding box

Range-90 <= value <= 90
minLng?number

Minimum longitude for geographic bounding box

Range-180 <= value <= 180
maxLng?number

Maximum longitude for geographic bounding box

Range-180 <= value <= 180
limit?integer

Maximum number of results to return

Range1 <= value <= 100
Default50
page?integer

Page number

Range1 <= value
Default1
categories?string

Comma-separated list of service/category name fragments to filter by (lab search only). Each fragment is matched case-insensitively against the lab's product category names.

sortBy?string

Sort order. 'distance' requires clinicLat and clinicLng; falls back to 'name' otherwise.

Default"name"

Value in

  • "name"
  • "distance"
clinicLat?number

Requesting organization's latitude (for distance sort).

Range-90 <= value <= 90
clinicLng?number

Requesting organization's longitude (for distance sort).

Range-180 <= value <= 180

Response Body

application/json

curl -X GET "https://example.com/partnerships/search?type=clinic"
{  "data": [    {      "id": "string",      "name": "string",      "city": "string",      "country": "string",      "logo": "string",      "latitude": "string",      "longitude": "string",      "description": "string",      "hasCoverImage": true,      "categories": [        "string"      ],      "partnershipStatus": "string",      "partnershipId": "string"    }  ],  "pagination": {    "page": 0,    "limit": 0,    "total": 0,    "totalPages": 0  }}
Empty
Empty
Empty

Resend partnership invitation email POST

Resend the invitation email for a pending partnership. Extends the invitation expiry by 30 days. Lab only - only the lab that initiated the partnership can resend.

Suspend an active partnership POST

Suspend an active partnership. Either party can suspend. Sends a notification to the other party. The partnership can later be reactivated. Available to both labs and clinics.