Overview
Campaigns
Products
Signals
Webhooks
Copy
curl -X GET "https://api.getstrato.dev/v1/kols?tier=tier_1&specialty=cardiology&per_page=10" \
-H "Authorization: Bearer sk_live_your_api_key"
Copy
{
"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": "[email protected]",
"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
}
}
KOLs
List KOLs
Retrieve a paginated list of KOLs in your organization.
GET
/
v1
/
kols
Copy
curl -X GET "https://api.getstrato.dev/v1/kols?tier=tier_1&specialty=cardiology&per_page=10" \
-H "Authorization: Bearer sk_live_your_api_key"
Copy
{
"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": "[email protected]",
"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
}
}
Query Parameters
Page number for pagination
Number of results per page (max 100)
Filter by KOL tier. Options:
tier_1, tier_2, tier_3Filter by specialty (e.g.,
cardiology, orthopedics)Filter by engagement level. Options:
high, medium, lowSearch by name, institution, or email
Filter by tags (comma-separated)
Include archived KOLs
Response
Show KOL object
Show KOL object
Unique identifier
Full name of the KOL
Professional title
Primary institution or hospital
Department within the institution
List of medical specialties
Specific areas of expertise
KOL tier classification
Current engagement level
Primary email address
Phone number
City and country information
Custom tags for organization
Number of events attended
ISO 8601 timestamp of last interaction
ISO 8601 timestamp
ISO 8601 timestamp
Pagination metadata
Copy
curl -X GET "https://api.getstrato.dev/v1/kols?tier=tier_1&specialty=cardiology&per_page=10" \
-H "Authorization: Bearer sk_live_your_api_key"
Copy
{
"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": "[email protected]",
"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
}
}
⌘I