curl -X GET "https://api.medstrato.com/v1/kols?tier=tier_1&specialty=cardiology&per_page=10" \
  -H "Authorization: Bearer sk_live_your_api_key"

const response = await medstrato.kols.list({
  tier: 'tier_1',
  specialty: 'cardiology',
  per_page: 10
});

response = medstrato.kols.list(
    tier='tier_1',
    specialty='cardiology',
    per_page=10
)

{
  "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": "s.chen@stanford.edu",
      "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
  }
}