Get followups
curl --request GET \
--url https://api.siro.ai/v1/core/followups \
--header 'x-siro-auth-token: <api-key>'import requests
url = "https://api.siro.ai/v1/core/followups"
headers = {"x-siro-auth-token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-siro-auth-token': '<api-key>'}};
fetch('https://api.siro.ai/v1/core/followups', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.siro.ai/v1/core/followups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-siro-auth-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.siro.ai/v1/core/followups"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-siro-auth-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.siro.ai/v1/core/followups")
.header("x-siro-auth-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.siro.ai/v1/core/followups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-siro-auth-token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"totalCount": 123,
"followups": [
{
"recordingId": "<string>",
"recordingTitle": "<string>",
"repName": "<string>",
"repId": "<string>",
"teamName": "<string>",
"teamId": "<string>",
"followupId": "<string>",
"dateCreated": "<string>",
"followupType": "REHASH",
"score": 123,
"followupAction": "<string>",
"context": [
{
"header": "<string>",
"value": "<string>"
}
],
"updatedAt": "<string>",
"metadata": [
{}
],
"starred": true,
"status": "TO_DO",
"thinking": "<string>",
"crmCustomer": {
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"organizationId": "<string>",
"name": "<string>",
"crmUrl": "<string>",
"customerType": "ACCOUNT",
"lastActivityAt": "<string>",
"closedAt": "2023-11-07T05:31:56Z",
"emailAddress": "<string>",
"phoneNumber": "<string>",
"externalId": "<string>",
"opportunityExternalId": "<string>",
"accountExternalId": "<string>",
"leadExternalId": "<string>",
"contactExternalId": "<string>",
"amount": 123,
"disposition": "<string>",
"recordingId": "<string>",
"lastRecordingDate": "2023-11-07T05:31:56Z",
"numRecordings": 123,
"matchingSource": "DIRECT",
"accountId": "<string>",
"accountOwnerName": "<string>",
"opportunityAccountName": "<string>",
"contactId": "<string>",
"opportunityContactName": "<string>",
"opportunityId": "<string>",
"engagementId": "<string>",
"opportunity": {
"id": "<string>",
"externalId": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"organizationId": "<string>",
"name": "<string>",
"amount": 123,
"closedAt": "<string>",
"disposition": "<string>",
"stageName": "<string>",
"deletedAt": "<string>",
"recordingId": "<string>",
"accountId": "<string>",
"account": null,
"opportunityUsers": [
null
]
},
"opportunities": {
"data": [
{
"id": "<string>",
"externalId": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"organizationId": "<string>",
"name": "<string>",
"amount": 123,
"closedAt": "<string>",
"disposition": "<string>",
"stageName": "<string>",
"deletedAt": "<string>",
"recordingId": "<string>",
"accountId": "<string>",
"account": null,
"opportunityUsers": [
null
]
}
],
"cursor": "<string>"
},
"opportunityUsers": [
null
],
"contactAccount": {
"id": "<string>",
"name": "<string>",
"externalId": "<string>"
},
"address": "<string>",
"integrationConnectionId": "<string>",
"integrationPlatform": "MERGE",
"integrationName": "<string>"
},
"hasFollowupComment": true,
"note": "<string>",
"completed": true,
"completedBy": "<string>",
"completedAt": "<string>",
"history": [
{
"id": "<string>",
"updatedBy": "<string>",
"updatedByUserId": "<string>",
"createdAt": "<string>",
"note": "<string>",
"status": "TO_DO"
}
],
"crmUrl": "<string>"
}
],
"totalRevenue": 123
},
"cursor": "<string>",
"pageSize": 123,
"limit": 123,
"total": 123,
"hasNextPage": true
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>",
"expected": "<string>",
"received": "<string>"
}
],
"name": "ZodError"
}{
"error": "<string>"
}Followups
Get followups
Retrieve followups with filtering and pagination support. Admins and coaches can access followups for their organization/teams, while regular users can only see their own followups.
GET
/
v1
/
core
/
followups
Get followups
curl --request GET \
--url https://api.siro.ai/v1/core/followups \
--header 'x-siro-auth-token: <api-key>'import requests
url = "https://api.siro.ai/v1/core/followups"
headers = {"x-siro-auth-token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-siro-auth-token': '<api-key>'}};
fetch('https://api.siro.ai/v1/core/followups', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.siro.ai/v1/core/followups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-siro-auth-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.siro.ai/v1/core/followups"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-siro-auth-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.siro.ai/v1/core/followups")
.header("x-siro-auth-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.siro.ai/v1/core/followups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-siro-auth-token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"totalCount": 123,
"followups": [
{
"recordingId": "<string>",
"recordingTitle": "<string>",
"repName": "<string>",
"repId": "<string>",
"teamName": "<string>",
"teamId": "<string>",
"followupId": "<string>",
"dateCreated": "<string>",
"followupType": "REHASH",
"score": 123,
"followupAction": "<string>",
"context": [
{
"header": "<string>",
"value": "<string>"
}
],
"updatedAt": "<string>",
"metadata": [
{}
],
"starred": true,
"status": "TO_DO",
"thinking": "<string>",
"crmCustomer": {
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"organizationId": "<string>",
"name": "<string>",
"crmUrl": "<string>",
"customerType": "ACCOUNT",
"lastActivityAt": "<string>",
"closedAt": "2023-11-07T05:31:56Z",
"emailAddress": "<string>",
"phoneNumber": "<string>",
"externalId": "<string>",
"opportunityExternalId": "<string>",
"accountExternalId": "<string>",
"leadExternalId": "<string>",
"contactExternalId": "<string>",
"amount": 123,
"disposition": "<string>",
"recordingId": "<string>",
"lastRecordingDate": "2023-11-07T05:31:56Z",
"numRecordings": 123,
"matchingSource": "DIRECT",
"accountId": "<string>",
"accountOwnerName": "<string>",
"opportunityAccountName": "<string>",
"contactId": "<string>",
"opportunityContactName": "<string>",
"opportunityId": "<string>",
"engagementId": "<string>",
"opportunity": {
"id": "<string>",
"externalId": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"organizationId": "<string>",
"name": "<string>",
"amount": 123,
"closedAt": "<string>",
"disposition": "<string>",
"stageName": "<string>",
"deletedAt": "<string>",
"recordingId": "<string>",
"accountId": "<string>",
"account": null,
"opportunityUsers": [
null
]
},
"opportunities": {
"data": [
{
"id": "<string>",
"externalId": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"organizationId": "<string>",
"name": "<string>",
"amount": 123,
"closedAt": "<string>",
"disposition": "<string>",
"stageName": "<string>",
"deletedAt": "<string>",
"recordingId": "<string>",
"accountId": "<string>",
"account": null,
"opportunityUsers": [
null
]
}
],
"cursor": "<string>"
},
"opportunityUsers": [
null
],
"contactAccount": {
"id": "<string>",
"name": "<string>",
"externalId": "<string>"
},
"address": "<string>",
"integrationConnectionId": "<string>",
"integrationPlatform": "MERGE",
"integrationName": "<string>"
},
"hasFollowupComment": true,
"note": "<string>",
"completed": true,
"completedBy": "<string>",
"completedAt": "<string>",
"history": [
{
"id": "<string>",
"updatedBy": "<string>",
"updatedByUserId": "<string>",
"createdAt": "<string>",
"note": "<string>",
"status": "TO_DO"
}
],
"crmUrl": "<string>"
}
],
"totalRevenue": 123
},
"cursor": "<string>",
"pageSize": 123,
"limit": 123,
"total": 123,
"hasNextPage": true
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"issues": [
{
"code": "<string>",
"path": [
"<string>"
],
"message": "<string>",
"expected": "<string>",
"received": "<string>"
}
],
"name": "ZodError"
}{
"error": "<string>"
}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
Uselimit (default 25, max 100) and the cursor from the previous response to walk pages. The cursor is opaque — pass it back unchanged.
Common filters
| Parameter | Use |
|---|---|
statuses | TO_DO, IN_PROGRESS, or COMPLETE |
minimumScore | Score floor (1–5, default 3) |
starred | Starred followups only |
createdAfter / createdBefore | ISO 8601 UTC window |
includeHistory | Include status changes and notes |
excludeCrmCustomer | Omit CRM customer block |
Related endpoints
Followups can also be embedded on a single recording viashowFollowups=true on Get recording details.Authorizations
Access token from POST https://auth.siro.ai/oauth2/token (client_credentials), or a Siro OAuth access token. Send x-siro-auth-token: <access-token>.