Calls & Campaigns
Get Agent Calls
Retrieve all calls for a specific agent with filtering and pagination
GET
Get Agent Calls
Retrieve all calls for a specific agent with various filtering options and pagination support.Endpoint
Path parameters
string
required
The unique identifier of the agent.
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_hereQuery parameters
string
Filter by call status. Options:
initiated, ringing, answered, completed, failed, busy, no-answerstring
Filter by call direction. Options:
inbound, outboundstring
Filter calls from date (YYYY-MM-DD)
string
Filter calls to date (YYYY-MM-DD)
string
Search in phone numbers or call SID
integer
Number of items per page (default: 20, max: 100)
integer
Page number (default: 1)
Example requests
Response
Success Response (200 OK)
Response fields
boolean
required
Indicates if the operation was successful.
array
required
Array of call objects for the specific agent.
object
required
Pagination metadata.
Error responses
404 Not Found
401 Unauthorized
422 Validation Error
500 Server Error
Error codes
Important notes
Agent-specific filtering. This endpoint returns only calls associated with the specified agent.
Same filtering options. All filtering options from the main calls endpoint are available.
No agent object. The response doesn’t include the agent object since it’s already specified in the URL.
Related endpoints
- List Calls:
GET /api/v1/calls - Get Agent:
GET /api/v1/agents/{agent_id} - List Campaigns:
GET /api/v1/campaigns