Skip to main content
GET
/
v1
/
kols
curl -X GET "https://api.medstrato.com/v1/kols?tier=tier_1&specialty=cardiology&per_page=10" \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "data": [
    {
      "id": "kol_abc123",
      "full_name": "Dr. Sarah Chen",
      "title": "Chief of Cardiology",
      "institution": "Stanford Medical Center",
      "department": "Cardiovascular Medicine",
      "specialties": ["interventional_cardiology", "structural_heart"],
      "expertise_areas": ["TAVR", "MitraClip", "left_atrial_appendage"],
      "tier": "tier_1",
      "engagement_level": "high",
      "email": "s.chen@stanford.edu",
      "phone": "+1-650-555-0123",
      "location": {
        "city": "Palo Alto",
        "country": "US"
      },
      "tags": ["speaker", "advisory_board", "investigator"],
      "event_count": 12,
      "last_interaction": "2024-01-15T10:30:00Z",
      "created_at": "2023-06-01T08:00:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 10,
    "total": 45,
    "total_pages": 5
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.medstrato.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Query Parameters

​
page
integer
default:"1"
Page number for pagination
​
per_page
integer
default:"20"
Number of results per page (max 100)
​
tier
string
Filter by KOL tier. Options: tier_1, tier_2, tier_3
​
specialty
string
Filter by specialty (e.g., cardiology, orthopedics)
​
engagement_level
string
Filter by engagement level. Options: high, medium, low
​
search
string
Search by name, institution, or email
​
tags
string
Filter by tags (comma-separated)
​
is_archived
boolean
default:"false"
Include archived KOLs

​
Response

​
data
array
​
meta
object
Pagination metadata
curl -X GET "https://api.medstrato.com/v1/kols?tier=tier_1&specialty=cardiology&per_page=10" \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "data": [
    {
      "id": "kol_abc123",
      "full_name": "Dr. Sarah Chen",
      "title": "Chief of Cardiology",
      "institution": "Stanford Medical Center",
      "department": "Cardiovascular Medicine",
      "specialties": ["interventional_cardiology", "structural_heart"],
      "expertise_areas": ["TAVR", "MitraClip", "left_atrial_appendage"],
      "tier": "tier_1",
      "engagement_level": "high",
      "email": "s.chen@stanford.edu",
      "phone": "+1-650-555-0123",
      "location": {
        "city": "Palo Alto",
        "country": "US"
      },
      "tags": ["speaker", "advisory_board", "investigator"],
      "event_count": 12,
      "last_interaction": "2024-01-15T10:30:00Z",
      "created_at": "2023-06-01T08:00:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 10,
    "total": 45,
    "total_pages": 5
  }
}