Skip to content
OnCoreDocs
Calls

GEThttps://core-api.heysadie.ai/calls

limit offset assistantId status dateFrom dateTo durationMin durationMax sortBy search success data calls id cid recordingUrl type startedAt endedAt transcript summary orgId cost costBreakdown customerNumber endedReason supervisorAnswered analysis messages callDuration assistantName createdAt updatedAt total metadata timestamp version path error code message details field

List calls

Try it in the API Explorer

Example request

Terminal
curl "https://core-api.heysadie.ai/calls?limit=10&offset=0" \
  -H "Authorization: ApiKey YOUR_API_KEY"

Authentication

Authenticate with an API key in the Authorization header using the ApiKey scheme — see Authentication for how keys work and where to get them.

Authorizationstringrequired

API key in the ApiKey scheme: ApiKey YOUR_API_KEY. Tenant keys authorize their own tenant; organization keys can act on any tenant in the organization.

X-Tenant-Idstring (uuid)optional

Required when authenticating with an organization key — selects the tenant the request acts on. Omit with tenant keys.

Request

Query parameters

limitstringoptional

Maximum number of items to return

offsetstringoptional

Number of items to skip from the beginning

assistantIdstringoptional

Filter by assistant ID (UUID)

statusstringoptional

Filter by call status

dateFromstringoptional

Filter calls started at or after this ISO datetime

dateTostringoptional

Filter calls started at or before this ISO datetime

durationMinstringoptional

Filter calls with duration >= this value (seconds)

durationMaxstringoptional

Filter calls with duration <= this value (seconds)

sortBystringoptional

Sort by field: startedAt (default) or createdAt

searchstringoptional

Free-text search across customer number and assistant name

Responses

200
successbooleanrequired
dataobjectoptional
Show 2 child properties
callsobject[]required

List of calls

Show 22 item properties
idstringrequired
cidstring | nulloptional

Provider call identifier (LiveKit). Correlates this call with performance metrics and session insights.

recordingUrlstring | nulloptional
typestring | nullrequired
startedAtstring (date-time) | string (date) | number | nullrequired
endedAtstring (date-time) | string (date) | number | nullrequired
transcriptstring | nullrequired
summarystring | nullrequired
orgIdstring | nullrequired
costnumber | nullrequired
costBreakdownany | nullrequired
customerNumberstring | nullrequired
statusstring | nullrequired
endedReasonstring | nullrequired
supervisorAnsweredboolean | nulloptional
analysisany | nullrequired
messagesany | nullrequired
callDurationnumber | nullrequired
assistantIdstring | nullrequired
assistantNamestring | nullrequired
createdAtstring (date-time) | string (date) | number | nullrequired
updatedAtstring (date-time) | string (date) | number | nullrequired
totalnumberrequired

Total number of calls found

metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
400
successbooleanrequired
errorobjectoptional
Show 3 child properties
codeenumrequired
Allowed values:"VALIDATION_ERROR"
messagestringrequired
detailsobject[]optional
Show 2 item properties
fieldstringrequired
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
401
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"UNAUTHORIZED"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
403
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"FORBIDDEN"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
404
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"RESOURCE_NOT_FOUND"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
500
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"INTERNAL_SERVER_ERROR"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional