Skip to main content
GET

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

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_here

Examples

Response

Active Call Found

No Active Call

Returns 404 Not Found.

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.