List Clinics

curl --request GET \
  --url https://api.getdoppel.ai/api/v1/api/v1/clinics \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getdoppel.ai/api/v1/api/v1/clinics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getdoppel.ai/api/v1/api/v1/clinics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getdoppel.ai/api/v1/api/v1/clinics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.getdoppel.ai/api/v1/api/v1/clinics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "clinics": [
      {}
    ]
  },
  "meta": {}
}

GET

api

clinics

List Clinics

curl --request GET \
  --url https://api.getdoppel.ai/api/v1/api/v1/clinics \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getdoppel.ai/api/v1/api/v1/clinics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getdoppel.ai/api/v1/api/v1/clinics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getdoppel.ai/api/v1/api/v1/clinics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.getdoppel.ai/api/v1/api/v1/clinics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "clinics": [
      {}
    ]
  },
  "meta": {}
}

List Clinics

Returns a list of all clinics you have access to. If your API key is restricted to specific clinics, only those clinics will be returned.

Request

GET https://api.getdoppel.ai/api/v1/clinics

Headers

Header	Required	Description
`Authorization`	Yes	Bearer token with your API key

Query Parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number (1-indexed)
`limit`	integer	25	Items per page (max: 500)

Response

boolean

Whether the request was successful

object

Show properties

array

Array of clinic objects

object

Pagination metadata

Clinic Object

Field	Type	Description
`id`	string	Unique clinic ID (UUID)
`name`	string	Clinic name
`address`	string	Clinic address
`phone`	string	Clinic phone number
`email`	string	Clinic email address
`timezone`	string	Clinic timezone (e.g., `Europe/Madrid`)
`created_at`	string	When the clinic was added (ISO 8601)

Examples

Basic Request

curl -X GET "https://api.getdoppel.ai/api/v1/clinics" \
  -H "Authorization: Bearer dpl_live_YOUR_API_KEY"

const response = await fetch('https://api.getdoppel.ai/api/v1/clinics', {
  headers: {
    'Authorization': 'Bearer dpl_live_YOUR_API_KEY'
  }
});
const data = await response.json();

import requests

response = requests.get(
    'https://api.getdoppel.ai/api/v1/clinics',
    headers={'Authorization': 'Bearer dpl_live_YOUR_API_KEY'}
)
data = response.json()

Response Example

{
  "success": true,
  "data": {
    "clinics": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "SmileUp Madrid Centro",
        "address": "Calle Gran Via 123, 28013 Madrid",
        "phone": "+34912345678",
        "email": "madrid@smileup.com",
        "timezone": "Europe/Madrid",
        "created_at": "2024-01-01T00:00:00.000Z"
      },
      {
        "id": "660f9511-f30c-52e5-b827-557766551111",
        "name": "SmileUp Barcelona",
        "address": "Passeig de Gracia 45, 08007 Barcelona",
        "phone": "+34934567890",
        "email": "barcelona@smileup.com",
        "timezone": "Europe/Madrid",
        "created_at": "2024-01-15T00:00:00.000Z"
      },
      {
        "id": "770a0622-g41d-63f6-c938-668877662222",
        "name": "SmileUp Valencia",
        "address": "Calle Colon 78, 46004 Valencia",
        "phone": "+34961234567",
        "email": "valencia@smileup.com",
        "timezone": "Europe/Madrid",
        "created_at": "2024-02-01T00:00:00.000Z"
      }
    ]
  },
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 3,
    "total_pages": 1,
    "has_more": false
  },
  "request_id": "req_abc123xyz",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

Use Cases

Build a Clinic Selector

Create a dropdown to filter data by clinic:

async function getClinicOptions(apiKey) {
  const response = await fetch('https://api.getdoppel.ai/api/v1/clinics', {
    headers: { 'Authorization': `Bearer ${apiKey}` }
  });
  const { data } = await response.json();

  return data.clinics.map(clinic => ({
    value: clinic.id,
    label: clinic.name
  }));
}

// Usage in a React component
function ClinicSelector({ apiKey, onSelect }) {
  const [options, setOptions] = useState([]);

  useEffect(() => {
    getClinicOptions(apiKey).then(setOptions);
  }, [apiKey]);

  return (
    <select onChange={(e) => onSelect(e.target.value)}>
      <option value="">All Clinics</option>
      {options.map(opt => (
        <option key={opt.value} value={opt.value}>
          {opt.label}
        </option>
      ))}
    </select>
  );
}

Get Clinic by ID

Find a specific clinic from the list:

import requests

def get_clinic_by_id(api_key, clinic_id):
    response = requests.get(
        'https://api.getdoppel.ai/api/v1/clinics',
        headers={'Authorization': f'Bearer {api_key}'}
    )
    clinics = response.json()['data']['clinics']
    return next(
        (c for c in clinics if c['id'] == clinic_id),
        None
    )

# Usage
clinic = get_clinic_by_id(
    'dpl_live_YOUR_API_KEY',
    '550e8400-e29b-41d4-a716-446655440000'
)
if clinic:
    print(f"Found clinic: {clinic['name']}")

Create a Clinic Summary Report

import requests

def generate_clinic_summary(api_key):
    # Get all clinics
    clinics_response = requests.get(
        'https://api.getdoppel.ai/api/v1/clinics',
        headers={'Authorization': f'Bearer {api_key}'}
    )
    clinics = clinics_response.json()['data']['clinics']

    summary = []
    for clinic in clinics:
        # Get metrics for each clinic
        metrics_response = requests.get(
            'https://api.getdoppel.ai/api/v1/metrics/summary',
            params={'clinic_id': clinic['id']},
            headers={'Authorization': f'Bearer {api_key}'}
        )
        metrics = metrics_response.json()['data']

        summary.append({
            'clinic_name': clinic['name'],
            'total_interactions': metrics['total_interactions'],
            'appointments_scheduled': metrics['appointments_scheduled'],
            'success_rate': metrics['success_rate']
        })

    return summary

# Usage
report = generate_clinic_summary('dpl_live_YOUR_API_KEY')
for clinic in report:
    print(f"{clinic['clinic_name']}: {clinic['appointments_scheduled']} appointments ({clinic['success_rate']}% success)")

API Key Restrictions

If your API key is restricted to specific clinics, only those clinics will appear in the response. Contact your account manager to modify clinic access.

List Interactions

Filter interactions by clinic.

Metrics Summary

Get metrics for specific clinics.

API Reference

Interactions

Metrics

Campaigns

Clinics

List Clinics

List Clinics

Request

Headers

Query Parameters

Response

Clinic Object

Examples

Basic Request

Response Example

Use Cases

Build a Clinic Selector

Get Clinic by ID

Create a Clinic Summary Report

API Key Restrictions

List Interactions

Metrics Summary

​List Clinics

​Request

​Headers

​Query Parameters

​Response

​Clinic Object

​Examples

​Basic Request

​Response Example

​Use Cases

​Build a Clinic Selector

​Get Clinic by ID

​Create a Clinic Summary Report

​API Key Restrictions

​Related Endpoints

List Interactions

Metrics Summary

List Clinics

Request

Headers

Query Parameters

Response

Clinic Object

Examples

Basic Request

Response Example

Use Cases

Build a Clinic Selector

Get Clinic by ID

Create a Clinic Summary Report

API Key Restrictions

Related Endpoints