List call summaries in a project, filtered and sorted on the server
vg_session<token>The console's session cookie, set when you sign in. Every operation accepts it, at the role the operation names.
orgId*stringAuthorised orgId; the server must verify organisation/project ownership before any read.
1 <= lengthprojectId*stringAuthorised projectId; the server must verify organisation/project ownership before any read.
1 <= lengthlimit?integerPage size, 1 to 100; omitted means 25.
1 <= value <= 10025cursor?stringOpaque nextCursor from prior response.
snapshot?stringSnapshot from prior response; required with cursor. It expires a day after the first page; an expired, unknown or malformed snapshot, or one sent for another project or other filters, is 400 invalid_request.
from?stringInclusive UTC start boundary applied to call startedAt.
date-timeto?stringExclusive UTC end boundary applied to call startedAt.
date-timeroom?stringExact room-name filter; may return multiple conversations.
channel?array<>How the call reached the agent. Repeat to match any listed channel.
issues?array<>Highest finding severity on the call: high, medium, or none for calls with neither. Repeat to match any.
answerMsMin?numberInclusive lower bound on the call's median answer time in milliseconds. Calls with an unknown answer time never match a bound.
0 <= valueanswerMsMax?numberInclusive upper bound on the call's median answer time in milliseconds. Calls with an unknown answer time never match a bound.
0 <= valuedurationSecondsMin?numberInclusive lower bound on call length in seconds. Unknown lengths never match a bound.
0 <= valuedurationSecondsMax?numberInclusive upper bound on call length in seconds. Unknown lengths never match a bound.
0 <= valueturnsMin?integerInclusive lower bound on agent turns. Unknown counts never match a bound.
0 <= valueturnsMax?integerInclusive upper bound on agent turns. Unknown counts never match a bound.
0 <= valueunknown?array<>Only calls where every listed value is unknown. This is how the console's "is empty" filter reaches the server; an unknown value is never matched as zero.
field?array<>An SDK call field as key:value. Repeat to keep calls holding every listed pair; one key with two values matches nothing. At most 16. An embed token without transcriptsAndAudio gets 403.
items <= 16tag?array<>User tag. Repeat to match calls carrying any listed tag.
recorded?booleantrue for calls with a retained recording, false for calls without one. Omitted means both.
archived?booleantrue for archived calls only, false for unarchived only. Omitted means both.
sort?stringSort key, applied on the server before paging. Unknown values sort after known values in both orders; ties break by id. A cursor is bound to the filters, sort and order it was issued for: changing any of them with a cursor is invalid_request.
"startedAt""startedAt""durationSeconds""turnCount""answerMs""issues"order?stringSort direction.
"desc""asc""desc"Authorised read result. Null means unreported, never zero. Source-specific coverage limits remain visible.
application/json- response
items*array<>page*totals*Figures over every call matching a listCalls request's range and filters, independent of paging. Design-preview calls are never counted.
curl -X GET 'https://example.com/api/v1/org/string/project/string/calls'{ "items": [ { "id": "string", "room": "string", "roomSid": "string", "startedAt": "2019-08-24T14:15:22Z", "endedAt": "2019-08-24T14:15:22Z", "durationSeconds": 0, "participantCount": 0, "endState": "observed", "channel": "phone", "pipeline": "cascaded", "models": [ "string" ], "agentKey": "string", "turnCount": 0, "answerMs": [ 0 ], "answerMsMedian": 0, "issues": { "high": 0, "medium": 0, "titles": [ "string" ] }, "tags": [ "string" ], "archived": true, "recorded": true } ], "page": { "nextCursor": "string", "snapshot": "string" }, "totals": { "callCount": 0, "byChannel": { "phone": 0, "web": 0, "console": 0, "local": 0, "unknown": 0 }, "answers": { "turns": 0, "overBudget": 0, "budgetMs": 100, "p50Ms": 0, "valuesMs": [ 0 ], "valuesTruncated": true }, "issues": { "high": 0, "medium": 0, "none": 0, "unknown": 0 }, "recorded": 0 }}Was this page helpful?