Skip to main content
GET
Get followups
Returns a paginated list of AI-generated followups tied to recordings. Each followup includes the source recording, rep/team context, score, status, and optional CRM customer data.

Access

Admins and coaches can list followups for their organization and teams. Regular users only see their own followups.

Pagination

Use limit (default 25, max 100) and the cursor from the previous response to walk pages. The cursor is opaque — pass it back unchanged.

Common filters

Followups can also be embedded on a single recording via showFollowups=true on Get recording details.

Authorizations

x-siro-auth-token
string
header
default:<oauth-access-token>
required

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

organizationId
string

Organization id

cursor
string

Pagination cursor returned by the previous page. Opaque base64-encoded token; do not parse or modify.

limit
integer

Maximum number of followups to return per page (1-100). Default is 25.

Required range: 1 <= x <= 100
Example:

25

minimumScore
integer | null
default:3

Filter by followup score equal to or greater than the minimum score. Can be between 1 and 5. Default is 3.

starred
boolean | null

Filter by followup starred state. A followup can be starred via the PATCH /followups/{followupId} endpoint. Default is false.

statuses
enum<string>[]
Available options:
TO_DO,
IN_PROGRESS,
COMPLETE
scores
(integer | null)[]
userIds
string[]
teamIds
string[]
createdAfter
string | null

Only include followups created after this timestamp (ISO 8601, UTC).

Example:

"2024-01-01T00:00:00Z"

createdBefore
string | null

Only include followups created before this timestamp (ISO 8601, UTC).

Example:

"2024-01-31T23:59:59Z"

conversationTypes
string[]
Maximum array length: 10
includeHistory
boolean | null

Whether to include followuphistory with the followup. Followup history returns all status changes and notes for the followup. Default is false.

excludeCrmCustomer
boolean | null

Whether to exclude the CRM customer for the followup. Default is false (CRM customer is included).

Response

Get followups

data
object
required
cursor
pageSize
number
limit
number
total
number | null
hasNextPage
boolean