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"
}
}
KOLs
Get KOL
Retrieve detailed information about a specific KOL.
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
The unique identifier of the KOL
Query Parameters
Include related data. Options:
events, campaigns, interactions, publications (comma-separated)Response
Show KOL object
Show KOL object
Unique identifier
Full name
Professional title
Primary institution
Department
Professional biography
Medical specialties
Specific expertise areas
Research focus areas
KOL tier (tier_1, tier_2, tier_3)
Engagement level (high, medium, low)
Contact information including email, phone, address
Social media profiles (LinkedIn, Twitter, etc.)
Engagement metrics and statistics
Recent events (if included)
Campaign history (if included)
Internal notes
Custom tags
Creation timestamp
Last update timestamp
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"
}
}
⌘I