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

Query parameters

string
Filter by call status. Options: initiated, ringing, answered, completed, failed, busy, no-answer
string
Filter by call direction. Options: inbound, outbound
string
Filter calls from date (YYYY-MM-DD)
string
Filter calls to date (YYYY-MM-DD)
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.
  • List Calls: GET /api/v1/calls
  • Get Agent: GET /api/v1/agents/{agent_id}
  • List Campaigns: GET /api/v1/campaigns