Skip to main content
GET
/
api
/
v1
/
callback-agents
/
stats
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"

{
  "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
      }
    ]
  }
}

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 callback statistics across all callback agents in your environment, optionally filtered by date range.

​
Endpoint

GET /api/v1/callback-agents/stats

​
Query Parameters

​
start_date
string
Start of the range (inclusive). Format: YYYY-MM-DD. Default: 30 days ago.
​
end_date
string
End of the range (inclusive). Format: YYYY-MM-DD. Default: today.

​
Request Headers

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here

​
Examples

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"

​
Response

{
  "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
      }
    ]
  }
}

​
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).