Skip to main content
GET
List Calls

Authorizations

Authorization
string
header
required

Use Tuner API key (tr_api_...) or user session token. Find your API key in Workspace Settings > API Keys.

Path Parameters

agent_id
string
required

Tuner's numeric agent ID, or your Agent ID from Agent Settings > Agent Connection. Digits-only values are read as the numeric ID.

workspace_id
integer
required

Workspace ID. Find this in Workspace > General Settings.

Query Parameters

page
integer
default:1

Page number

Required range: x >= 1
page_size
integer
default:10

Items per page

Required range: 1 <= x <= 100
search
string | null

Search by call ID

start_date
string | null

Start date (ISO 8601)

end_date
string | null

End date (ISO 8601)

min_duration_seconds
integer | null

Minimum duration in seconds

Required range: x >= 0
max_duration_seconds
integer | null

Maximum duration in seconds

Required range: x >= 0
call_intents
string | null

Comma-separated list of call intents

call_outcomes
string | null

Comma-separated list of call outcomes

sentiment
string | null

Sentiment filter (positive/neutral/negative/unknown)

labels_and_redflags
string | null

Comma-separated list of labels and red flags

sort_by
string
default:start_time

Sort field

sort_order
string
default:desc

Sort order (asc/desc)

simulated
boolean | null

Filter simulation calls (true/false)

alert_ids
string | null

Only calls that matched any of these alerts. Comma-separated alert ids belonging to this agent.

alert_trigger_id
integer | null

Only the calls behind one alert trigger: the calls that were counted when that trigger fired. Use the trigger id sent in the alert.fired webhook. A trigger that does not belong to one of this agent's alerts, or has no saved calls, returns an empty list. Combines with the other filters.

Response

Successful Response

Paginated call logs response.

calls
CallLogResponse · object[]
required

List of call logs

total
integer
required

Total count of matching calls

page
integer
required

Current page number

page_size
integer
required

Items per page

total_pages
integer
required

Total number of pages