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

# Get Callback Stats

> Retrieve aggregated statistics for callback agents

# Get Callback Stats

Retrieve aggregated callback statistics across all callback agents in your environment, optionally filtered by date range.

## Endpoint

```
GET /api/v1/callback-agents/stats
```

## Query parameters

<ParamField query="start_date" type="string">Start of the range (inclusive). Format: `YYYY-MM-DD`. Default: 30 days ago.</ParamField>
<ParamField query="end_date" type="string">End of the range (inclusive). Format: `YYYY-MM-DD`. Default: today.</ParamField>

## Request headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Format: `Bearer talq_your_environment_token_here`
</ParamField>

## Examples

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/callback-agents/stats?start_date=2024-01-01&end_date=2024-01-31" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "period": {
        "start": "2024-01-01",
        "end": "2024-01-31"
      },
      "total_callbacks_received": 184,
      "callbacks_answered": 142,
      "callbacks_unmatched": 12,
      "callbacks_by_source_agent": [
        {
          "source_agent_id": "agent-uuid-2",
          "name": "Sales Outbound",
          "count": 110
        },
        {
          "source_agent_id": "agent-uuid-3",
          "name": "Survey Outbound",
          "count": 74
        }
      ]
    }
  }
  ```
</ResponseExample>

### Field Definitions

* `total_callbacks_received` — total inbound calls routed to callback agents.
* `callbacks_answered` — callbacks that successfully connected with the agent.
* `callbacks_unmatched` — inbound calls that hit a callback agent but had no recent matching outbound call (the contact wasn't on a source list).