curl "https://app.talkover.ai/api/v1/agents/agent-uuid/active-call/%2B15551234567" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": [
{
"id": "call-uuid-1",
"agent_id": "agent-uuid",
"to": "+15551234567",
"status": "answered",
"started_at": "2024-01-15T11:00:00Z",
"duration_seconds": 42
}
]
}
Make a Call
Get Active Call by Phone
Find the active call between an agent and a phone number
GET
/
api
/
v1
/
agents
/
{agent_id}
/
active-call
/
{phone}
curl "https://app.talkover.ai/api/v1/agents/agent-uuid/active-call/%2B15551234567" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": [
{
"id": "call-uuid-1",
"agent_id": "agent-uuid",
"to": "+15551234567",
"status": "answered",
"started_at": "2024-01-15T11:00:00Z",
"duration_seconds": 42
}
]
}
Get Active Call by Phone
Find the active call (if any) between an agent and a specific phone number. Useful for de-duplication checks before placing a new call, or to look up the call ID associated with an inbound caller.Endpoint
GET /api/v1/agents/{agent_id}/active-call/{phone}
Path parameters
string
required
Agent UUID.
string
required
Phone number in E.164 format (e.g.,
+15551234567). URL-encode the + sign as %2B.Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_hereExamples
curl "https://app.talkover.ai/api/v1/agents/agent-uuid/active-call/%2B15551234567" \
-H "Authorization: Bearer talq_your_environment_token_here"
Response
Active Call Found
{
"success": true,
"data": [
{
"id": "call-uuid-1",
"agent_id": "agent-uuid",
"to": "+15551234567",
"status": "answered",
"started_at": "2024-01-15T11:00:00Z",
"duration_seconds": 42
}
]
}
No Active Call
Returns404 Not Found.
{
"success": false,
"message": "No active call found for this phone number"
}
Notes
- Only calls with status
initiated,ringing, oransweredare considered active. - If multiple active calls exist (rare — typically only one), all are returned in the array.
- For historical lookups, use List Calls with
tofilter.
Was this page helpful?