Skip to main content
GET
/
v1
/
kols
/
{id}
curl -X GET "https://api.medstrato.com/v1/kols/kol_abc123?include=events,campaigns" \
  -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",
    "bio": "Dr. Chen is a leading interventional cardiologist specializing in structural heart procedures...",
    "specialties": ["interventional_cardiology", "structural_heart"],
    "expertise_areas": ["TAVR", "MitraClip", "left_atrial_appendage"],
    "research_interests": ["transcatheter valve replacement", "heart failure devices"],
    "tier": "tier_1",
    "engagement_level": "high",
    "contact": {
      "email": "s.chen@stanford.edu",
      "phone": "+1-650-555-0123",
      "address": {
        "street": "300 Pasteur Drive",
        "city": "Palo Alto",
        "state": "CA",
        "postal_code": "94305",
        "country": "US"
      }
    },
    "social": {
      "linkedin": "https://linkedin.com/in/drsarahchen",
      "twitter": "@DrSarahChen"
    },
    "metrics": {
      "total_events": 12,
      "total_campaigns": 8,
      "email_open_rate": 0.85,
      "response_rate": 0.72,
      "h_index": 45,
      "publications_count": 120
    },
    "events": [
      {
        "id": "evt_xyz789",
        "name": "Q4 Cardiology Advisory Board",
        "date": "2024-01-15",
        "role": "speaker"
      }
    ],
    "campaigns": [
      {
        "id": "cmp_def456",
        "name": "TAVR Product Launch",
        "sent_at": "2024-01-10",
        "status": "opened"
      }
    ],
    "notes": "Key opinion leader for structural heart. Prefers email contact.",
    "tags": ["speaker", "advisory_board", "investigator"],
    "created_at": "2023-06-01T08:00:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

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.

Path Parameters

id
string
required
The unique identifier of the KOL

Query Parameters

include
string
Include related data. Options: events, campaigns, interactions, publications (comma-separated)

Response

data
object
curl -X GET "https://api.medstrato.com/v1/kols/kol_abc123?include=events,campaigns" \
  -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",
    "bio": "Dr. Chen is a leading interventional cardiologist specializing in structural heart procedures...",
    "specialties": ["interventional_cardiology", "structural_heart"],
    "expertise_areas": ["TAVR", "MitraClip", "left_atrial_appendage"],
    "research_interests": ["transcatheter valve replacement", "heart failure devices"],
    "tier": "tier_1",
    "engagement_level": "high",
    "contact": {
      "email": "s.chen@stanford.edu",
      "phone": "+1-650-555-0123",
      "address": {
        "street": "300 Pasteur Drive",
        "city": "Palo Alto",
        "state": "CA",
        "postal_code": "94305",
        "country": "US"
      }
    },
    "social": {
      "linkedin": "https://linkedin.com/in/drsarahchen",
      "twitter": "@DrSarahChen"
    },
    "metrics": {
      "total_events": 12,
      "total_campaigns": 8,
      "email_open_rate": 0.85,
      "response_rate": 0.72,
      "h_index": 45,
      "publications_count": 120
    },
    "events": [
      {
        "id": "evt_xyz789",
        "name": "Q4 Cardiology Advisory Board",
        "date": "2024-01-15",
        "role": "speaker"
      }
    ],
    "campaigns": [
      {
        "id": "cmp_def456",
        "name": "TAVR Product Launch",
        "sent_at": "2024-01-10",
        "status": "opened"
      }
    ],
    "notes": "Key opinion leader for structural heart. Prefers email contact.",
    "tags": ["speaker", "advisory_board", "investigator"],
    "created_at": "2023-06-01T08:00:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}