> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getdoppel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference Overview

> Complete reference for all Doppel API endpoints

# API Reference

This section contains detailed documentation for all Doppel API endpoints.

## Base URL

```
https://api.getdoppel.ai/api/v1
```

## Available Endpoints

### Interactions

| Method | Endpoint        | Description                          |
| ------ | --------------- | ------------------------------------ |
| `GET`  | `/interactions` | List all interactions with filtering |

### Metrics

| Method | Endpoint            | Description           |
| ------ | ------------------- | --------------------- |
| `GET`  | `/metrics/summary`  | Get aggregated KPIs   |
| `GET`  | `/metrics/outcomes` | Get outcome breakdown |
| `GET`  | `/metrics/daily`    | Get daily time series |

### Campaigns

| Method | Endpoint     | Description        |
| ------ | ------------ | ------------------ |
| `GET`  | `/campaigns` | List all campaigns |

### Clinics

| Method | Endpoint   | Description      |
| ------ | ---------- | ---------------- |
| `GET`  | `/clinics` | List all clinics |

### OpenAPI Specification

| Method | Endpoint        | Description                   |
| ------ | --------------- | ----------------------------- |
| `GET`  | `/openapi.json` | Get OpenAPI 3.0 specification |

## Common Parameters

### Pagination

Most list endpoints support pagination:

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

### Date Filtering

Many endpoints support date range filtering:

| Parameter   | Type   | Format   | Description |
| ----------- | ------ | -------- | ----------- |
| `date_from` | string | ISO 8601 | Start date  |
| `date_to`   | string | ISO 8601 | End date    |

Example:

```
?date_from=2024-01-01&date_to=2024-12-31
```

## Response Format

All responses follow this structure:

```json theme={null}
{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 150,
    "total_pages": 6,
    "has_more": true
  },
  "request_id": "uuid",
  "timestamp": "ISO 8601"
}
```
