Get recordings
Get recordings with optional filtering and pagination
Pagination
Uselimit (default 100, max 100) and the cursor from the previous response to walk pages. The cursor is opaque — pass it back unchanged.
Common filters
| Parameter | Use |
|---|---|
organizationId | Scope to one organization |
teamId | One or more team IDs (comma-separated) |
conversationType | Filter by conversation type name(s), comma-separated |
result | closed, not closed, or in progress |
dateCreated:gt / dateCreated:lt | ISO 8601 UTC window on recording creation |
crmLinkStatus | unlinked — recordings with no confirmed CRM customer link |
orderBy / orderDirection | Sort by any filterable field (asc or desc) |
Optional enrichments
| Flag | Adds |
|---|---|
showCrmCustomer=true | crmCustomer block per recording |
showFollowups=true | followups array per recording |
showEvaluationScore=true | Evaluation score per recording |
Related endpoints
For full recording payloads (summary, entity extractions, signed video URL), use Get recording details. For org-wide bulk sync with CRM link IDs, see the org-scoped Get recordings endpoint. To list followups across recordings, see Get followups.Authorizations
OAuth access token for user-scoped requests (Authorization Code or machine-to-machine). Send header x-siro-auth-token: <oauth-access-token>. Not an organization API key.
Query Parameters
Number of results to return per page (default is 100, max is 100)
Filter by conversation type name(s), e.g. "My Best Convo". Multiple types can be specified as comma-separated values
Result of the recording (e.g., closed, not closed).
Filter by organization ID
Filter by team ID(s). Multiple teams can be specified as comma-separated values
Return results created after the given date. Format: ISO 8601 timestamp (YYYY-MM-DDTHH:mm:ss.sssZ)
Return results created before the given date. Format: ISO 8601 timestamp (YYYY-MM-DDTHH:mm:ss.sssZ)
Field to order results by. It is possible to order by any filterable field.
Order direction: "asc" or "desc"
asc, desc Cursor for pagination
Filter by CRM link status: "unlinked" finds recordings with no definitively linked opportunity or engagement that is linked to a customer (account/contact/lead)
unlinked Whether to include CRM customer data for each recording
true, false Whether to include evaluationScore for each recording (true/false)
true, false Whether to include followups for each recording
true, false