Skip to main content
GET
/
v1
/
kols
/
{id}
curl -X GET "https://api.getstrato.dev/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": "[email protected]",
      "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"
  }
}

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.getstrato.dev/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": "[email protected]",
      "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"
  }
}