Skip to main content
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
    }
  ]
}

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 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

agent_id
string
required
Agent UUID.
phone
string
required
Phone number in E.164 format (e.g., +15551234567). URL-encode the + sign as %2B.

Request Headers

Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here

Examples

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

Returns 404 Not Found.
{
  "success": false,
  "message": "No active call found for this phone number"
}

Notes

  • Only calls with status initiated, ringing, or answered are considered active.
  • If multiple active calls exist (rare — typically only one), all are returned in the array.
  • For historical lookups, use List Calls with to filter.