Get recordings
Get recordings
Deleted recordings
Every recording carries two core fields (always present, no opt-in required) that tell you whether it has been deleted in Siro:updatedAt filters and reconcile them in your own system (deleting a recording bumps its updatedAt). Treat deleted: true as a signal to hide or remove the recording on your side; the Siro app already hides these from its Recordings view.
Enriching the response
The org-scoped recordings endpoints can optionally hydrate extra blocks of data, each behind an opt-in query flag:=true to enable.
crm — CRM link IDs
When showCrmLinks=true, crm contains the external IDs of the CRM records the recording is linked to. Every linked object is returned as a pair:
id— Siro’s internal ID for the objectexternalId— that object’s ID in your CRM (use this to join)
integrations.recordingProcessed webhook, so pull-based polling and push-based webhooks give you identical CRM references.
crm is null when the recording has no confirmed CRM link yet. Because links can be established after a recording is created, poll the list endpoint with the updatedAt filters to pick up recordings as they become linked.summary
When showSummary=true, summary is the recording’s AI summary as an ordered array of sections:
[] if the recording has no summary yet.
entityExtractions
When showEntityExtractions=true, entityExtractions is a flat list of the values extracted from the conversation, including the CRM field each maps to:
[] if there are none. Use mappings to write each value to the corresponding field on the CRM record from the crm block.
followups
When showFollowups=true, followups is an array of AI-generated followups tied to the recording. The payload differs by endpoint:
List (GET /v1/core/recordings) returns slim summaries:
showFollowups=true when you need the full followup payload for a specific recording.
Single recording (GET /v1/core/recordings/{id}) returns the full followup payload, including:
Example
Putting it together
A typical pipeline poll:- Call
GET /v1/core/recordings?updatedAt:gte=<last_poll>&showCrmLinks=trueto fetch recordings linked since your last poll, with their CRM IDs. - Join each recording to your CRM using
crm.engagement.externalId(appointment) /crm.account.externalId/ etc. - For recordings you want to enrich, request
showSummary/showEntityExtractions(on this list call or the single-recording endpoint) and writeentityExtractionsvalues back using theirmappings.
Authorizations
Organization integration token from Siro admin (Person icon → API Tokens). Send Authorization: Bearer . This is not the OAuth access token used with api.siro.ai user-scoped endpoints.
Query Parameters
Return results created strictly after the given date (exclusive). Format: ISO 8601 timestamp (YYYY-MM-DDTHH:mm:ss.sssZ). Example: 2024-06-13T04:00:00.592Z
Return results created strictly before the given date (exclusive). Format: ISO 8601 timestamp (YYYY-MM-DDTHH:mm:ss.sssZ). Example: 2024-06-13T04:00:00.592Z
Return results updated at or after the given date (inclusive). Use this for incremental polling. Format: ISO 8601 timestamp (YYYY-MM-DDTHH:mm:ss.sssZ). Example: 2024-06-13T04:00:00.592Z
Return results updated strictly after the given date (exclusive). Format: ISO 8601 timestamp (YYYY-MM-DDTHH:mm:ss.sssZ). Example: 2024-06-13T04:00:00.592Z
Return results updated strictly before the given date (exclusive). Format: ISO 8601 timestamp (YYYY-MM-DDTHH:mm:ss.sssZ). Example: 2024-06-13T04:00:00.592Z
Return results updated at or before the given date (inclusive). Format: ISO 8601 timestamp (YYYY-MM-DDTHH:mm:ss.sssZ). Example: 2024-06-13T04:00:00.592Z
Number of results to return per page (default is 25).
Cursor for pagination.
Filter by processing status.
true, false Filter by entity extraction status.
true, false Filter by summary status.
true, false Include CRM link IDs for the recording (integration connection, users, engagement, opportunity, contacts, account, lead).
true, false Include the recording summary results.
true, false Include the recording entity extractions.
true, false Include the scorecard evaluation score for the recording.
true, false Include followups for the recording. List returns id/score summaries; GET by id returns the full followup payload.
true, false