Get interactions
Returns a page of interactions — conversations that took place — for one agent in a date range. Pass an item’s interaction_id to Get transcript or Get recording.
Set include_transcript=true to get transcripts inline, or include_forwarded_calls=true for call transfers.
Responses are cached for 60 seconds. Each item includes user_contact, the user’s full, unmasked phone number or email. Treat responses as personal data.
Path parameters
Agent ID. Copy it from the agent’s ··· menu in the dashboard (Copy agent ID).
Headers
Query parameters
Field to sort by. Default interaction_id. Unknown values return 422.
asc (default) or desc. Case-insensitive.
Start of the range, inclusive. ISO 8601 with an offset, e.g. 2026-10-01T00:00:00+05:30 (encode + as %2B). Without an offset, UTC is assumed.
End of the range, inclusive. Same format as start_datetime, and must be later than it.
Items per page, 1–1000. Default 20.
Items to skip. Default 0. To page, you can follow next_page_uri instead.
URL-encoded JSON array of {field, operator, value} conditions. value is always a string, even for numbers. Conditions on the same field are ORed; on different fields, ANDed.
[{"field": "duration_in_seconds", "operator": "greater_than", "value": "30"}]
Operators and filterable fields are listed under Filtering.
Add original_transcript and its English translation translate_transcript to each item. Default false.
Add forwarded_calls, the call transfers made during each interaction. Default false.
Return only interactions that were forwarded. Implies include_forwarded_calls. Default false.
Response
The limit applied to this page.
The offset applied to this page.
Query string for the next page, e.g. ?start_datetime=...&limit=20&offset=20. Append it to the endpoint path. "" when there is no next page.
Query string for the previous page. "" when there is none.