Overview
The MedStrato API enables you to programmatically access and manage your medical device commercial operations data. Use it to:
- Sync KOL data with your CRM or internal systems
- Automate event workflows and attendee management
- Trigger campaigns based on external events
- Monitor regulatory signals and integrate with compliance tools
- Export analytics for business intelligence
Base URL
All API requests should be made to:
https://api.getstrato.dev/v1
Authentication
The MedStrato API uses API keys for authentication. Include your API key in the Authorization header:
curl -X GET "https://api.getstrato.dev/v1/kols" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json"
Keep your API keys secure. Do not expose them in client-side code or public repositories.
Obtaining API Keys
- Go to Settings → API Keys in your MedStrato dashboard
- Click Create API Key
- Copy the key immediately (it won’t be shown again)
- Set appropriate scopes for your use case
API Key Scopes
| Scope | Description |
|---|
kols:read | Read KOL profiles and insights |
kols:write | Create and update KOL records |
events:read | Read events and attendees |
events:write | Create and manage events |
campaigns:read | Read campaign data and analytics |
campaigns:write | Create and send campaigns |
signals:read | Read regulatory signals |
products:read | Read product catalog |
products:write | Manage products |
Rate Limits
API requests are rate-limited based on your subscription plan:
| Plan | Requests per minute | Requests per day |
|---|
| Starter | 60 | 10,000 |
| Professional | 300 | 100,000 |
| Enterprise | 1,000 | Unlimited |
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1699900000
Success Response
{
"data": { ... },
"meta": {
"page": 1,
"per_page": 20,
"total": 150
}
}
Error Response
{
"error": {
"code": "invalid_request",
"message": "The 'email' field is required",
"details": {
"field": "email",
"reason": "missing"
}
}
}
HTTP Status Codes
| Code | Description |
|---|
200 | Success |
201 | Created |
400 | Bad Request - Invalid parameters |
401 | Unauthorized - Invalid or missing API key |
403 | Forbidden - Insufficient permissions |
404 | Not Found |
429 | Too Many Requests - Rate limited |
500 | Internal Server Error |
| Parameter | Default | Description |
|---|
page | 1 | Page number |
per_page | 20 | Items per page (max 100) |
sort | varies | Sort field |
order | desc | Sort order (asc or desc) |
Filtering
Most list endpoints support filtering:
GET /v1/kols?tier=tier_1&specialty=cardiology&engagement_level=high
GET /v1/events?status=scheduled,active&event_type=advisory_board
Webhooks
MedStrato can send real-time notifications to your server when events occur. See the Webhooks documentation for setup instructions.
SDKs & Libraries
Need Help?
