Skip to main content

​
Quickstart

This guide will help you make your first API request in just a few minutes.

​
Step 1: Get your API key

Contact your Doppel account manager to receive your API key. The key will look like: 
dpl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Keep your API key secure. Never expose it in client-side code or public repositories.

​
Step 2: Make your first request

Let’s start by listing your clinics. Replace YOUR_API_KEY with your actual key: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.getdoppel.ai/api/v1/clinics"

​
Step 3: Explore interactions

Now let’s fetch your recent interactions: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.getdoppel.ai/api/v1/interactions?limit=10"

​
Step 4: Get metrics

Retrieve aggregated metrics for a date range: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.getdoppel.ai/api/v1/metrics/summary?date_from=2024-01-01&date_to=2024-12-31"

​
Step 5: Get your bookings

Retrieve all appointment-related interactions (booked, modified, cancelled): 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.getdoppel.ai/api/v1/interactions?outcome=APPOINTMENT_BOOKED,APPOINTMENT_MODIFIED,APPOINTMENT_CANCELLED"
You can filter by multiple outcomes using comma-separated values. See Filtering Interactions for more options.

​
Next steps

Authentication

Learn more about API key authentication and scopes.

Rate Limits

Understand rate limiting and how to handle it.

Filtering Interactions

Master the powerful filtering options for interactions.

API Reference

Explore all available endpoints.