API Reference

Retrieve a list of calls for a specific agent

get
https://company_subdomain.talkpush.com/api/talkpush_services/agents//calls

Returns a paginated list of call records handled by the given agent, ordered by most recent first. Each record includes the associated application (candidate / campaign invitation) context, extracted data, interview insights, transcript, and a link to the call recording when available.

Optional filters:

  • status: filter by call status.
  • start_date + end_date: filter by creation date range. Both parameters must be provided together. Any format accepted by Time.zone.parse is supported (e.g. 2026-04-01, 2026-04-01T00:00:00Z).
Path Params
integer
required

The ID of the agent whose calls should be returned.

Query Params
string
required

The API key provided for your application.

string
enum

Filter by call status.

string

Start of the creation-date range filter. Must be provided together with end_date. Any format parseable by Time.zone.parse is accepted (e.g. 2026-04-01, 2026-04-01T00:00:00Z).

string

End of the creation-date range filter. Must be provided together with start_date.

integer
Defaults to 1

Page number of the results to return. Default is 1.

integer
≤ 100
Defaults to 20

Number of records per page. Default is 20, maximum is 100.

Responses

400

Bad request. Possible messages:

  • start_date and end_date are both required when filtering by date (when only one of the two date parameters is supplied).
  • Invalid date format for start_date or end_date (when a date parameter cannot be parsed).
  • status must be one of: <allowed values> (when the provided status is not recognized).
401

Invalid API key.

404

Agent not found.

500

Internal server error, we will provide you with the exception message of the application.

Updated 3 months ago

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?