Skip to Content
Call AnalyticsCall Records

Call Records

POST/api/app/public-calls/get-calls
Queries the analyzed call records of the tenant. Only calls that belong to the token owner's tenant and whose analysis is complete are returned.

Request Body

{ "startTime": "2026-04-01T00:00:00", "endTime": "2026-04-10T23:59:59", "skip": 0, "take": 20, "sortColumn": "start_time_dt", "isAscending": false, "issueTypeNames": ["Şikayet", "Teknik Sorun"], "hasNewRequest": true, "direction": 1, "results": [1], "includeAnalysis": false }

Text values in the examples (call types, queue names, labels such as directionName or resultName) are shown as they are returned for a Turkish-speaking tenant. Field names and the payload structure are the same for every tenant.

Parameters

FieldTypeRequiredDescription
startTimedatetimeNoStart date (inclusive). Must be sent in ISO 8601 format. If omitted, no lower bound is applied; providing a date range is still recommended.
endTimedatetimeNoEnd date (inclusive). Must be sent in ISO 8601 format. If omitted, no upper bound is applied; providing a date range is still recommended.
skipintNoNumber of records to skip. Used for pagination. Default: 0. A negative value returns an error.
takeintNoNumber of records to return. If empty or 0, the default of 20 is used. The allowed maximum depends on includeAnalysis: 500 if false, 100 if true. If the limit is exceeded, the request is rejected with a 400 validation error (it is not silently reduced).
sortColumnstringNoSort field. If omitted, results are sorted by start date in descending order.
isAscendingboolNotrue for ascending, false for descending order. Default: false.
issueTypeNamesarrayNoCall type filter. When provided, only records of the given call types are returned. If left empty, no call type filter is applied and all call types are listed. An undefined value returns an error.
hasNewRequestboolNoFilters calls that contain a new request. If true, only records with a populated newRequestInfo field are returned; if false, only records without it. If omitted (null), no filter is applied.
directionintNoCall direction filter. 0 = Inbound, 1 = Outbound. If omitted, both directions are listed.
resultsarrayNoCall result filter (IN). Values: 1 = Answered, 2 = Rejected (legacy records), 3 = Busy, 4 = Not Answered, 5 = Missed, 6 = Failed, 7 = Invalid Number. If the field is omitted entirely, only Answered (1) results are returned by default. If explicitly sent as null, no result filter is applied.
includeAnalysisboolNoIf true, the extended analysis fields (analysis) are populated for each record and the maximum take is limited to 100. If false (default), analysis is returned empty and the maximum take can go up to 500.

The sum of skip + take cannot exceed 10,000. If it does, the system automatically reduces the page size.

Only calls whose analysis is complete are listed. A call that is still being analyzed does not appear in the results until its analysis finishes.

issueTypeNames values are matched against the Value or Description fields of the call type catalog in the system. An undefined value returns an error.

The results field has a different default behavior: if it is not included in the request at all, only calls with the Answered status are returned. To see all results, send "results": null.

Validation Errors

In the following cases, 400 Bad Request is returned in the standard ABP validation error format:

  • The request body is empty (request is null)
  • startTime is later than endTime
  • skip is negative
  • take exceeds the applicable maximum (includeAnalysis: false → 500, true → 100)
400Validation error
{ "error": { "code": null, "message": "Doğrulama hatası.", "details": null, "validationErrors": [ { "message": "Başlangıç tarihi, bitiş tarihinden büyük olamaz.", "members": ["startTime", "endTime"] } ] } }

Date and Time Behavior

The returned callDate value may be converted according to the user’s time zone setting. The integration team should agree on a single convention when sending dates.

RecommendationDescription
ISO 8601Send all dates in the 2026-04-01T00:00:00 format
Time zone conventionAgree within your team whether UTC or Europe/Istanbul will be used

Example cURL

curl --request POST 'https://public-api.thinkvoice.ai/api/app/public-calls/get-calls' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' --header 'Content-Type: application/json' --data-raw '{
  "startTime": "2026-04-01T00:00:00",
  "endTime": "2026-04-10T23:59:59",
  "skip": 0,
  "take": 20,
  "isAscending": false,
  "issueTypeNames": ["Şikayet", "Teknik Sorun"],
  "hasNewRequest": true,
  "direction": 1,
  "results": [1],
  "includeAnalysis": false
}'

Responses

200Success
{ "items": [ { "callId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "customerId": "11111111-2222-3333-4444-555555555555", "customerPhoneNumber": "+905xxxxxxxxx", "callDate": "2026-04-10T14:35:12", "queueName": "Musteri Hizmetleri", "topic": "Odeme", "subTopic": "Iade > Gecikme", "resolutionStatus": "Cozuldu", "title": "Iade sureciyle ilgili sikayet", "summary": "Musteri, [MASKED] numarasi icin iade surecinin geciktigini belirtti.", "callIssueType": "Şikayet", "newRequestInfo": "Müşteri, iade sürecinin durumunu uygulama üzerinden takip edebilmek için yeni bir özellik talep etti.", "direction": 1, "directionName": "Giden", "resultId": 1, "resultName": "Cevaplandı", "hangupDirectionId": 1, "hangupDirectionName": "Müşteri", "endTime": "2026-04-10T14:41:47", "answerTime": "2026-04-10T14:35:20", "callDurationSeconds": 387.5, "queueWaitSeconds": 12, "personnelId": "22222222-3333-4444-5555-666666666666", "personnelName": "Ayşe Yılmaz", "agentId": "agent-42", "agentName": "İade Botu", "analysis": [], "metadata": null, "recordUrl": "https://public-api.thinkvoice.ai/api/app/public-calls/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/record" } ], "totalResultCount": 153, "totalPageCount": 8, "sortableColumns": [] }

Because includeAnalysis: false was sent in the example above, analysis is returned as an empty array. If includeAnalysis: true is sent, each item is populated with analysis parameters in the { key, friendlyName, value } form, for example: [{ "key": "musteri_memnuniyeti", "friendlyName": "Müşteri Memnuniyeti", "value": "Olumlu" }].

401Token is invalid or missing
{ "error": "invalid_token" }
429Rate limit exceeded — 40 requests / 60 seconds
Retry-After: 60

Response Fields

FieldTypeRequiredDescription
callIdstringNoUnique identifier of the call in the system.
customerIdstringNoUnique identifier of the customer in the system.
customerPhoneNumberstringNoCustomer phone number. Returns null if no number is on record.
callDatedatetimeNoCall date. May be converted according to the user's time zone setting.
queueNamestringNoQueue the call belongs to.
topicstringNoMain topic.
subTopicstringNoSubtopic chain.
resolutionStatusstringNoText representation of the resolution status.
titlestringNoCall title. Sensitive data is masked.
summarystringNoSummary text. Data such as phone numbers, email addresses and national ID numbers (TCKN) are returned as [MASKED].
callIssueTypestringNoCall type.
newRequestInfostringNoNew request or feature request information. Returns null if there is none.
directionintNoCall direction. 0 = Inbound, 1 = Outbound.
directionNamestringNoText representation of the call direction, e.g. "Gelen" (Inbound), "Giden" (Outbound).
resultIdintNoCall result ID. 1 = Answered, 2 = Rejected (legacy records), 3 = Busy, 4 = Not Answered, 5 = Missed, 6 = Failed, 7 = Invalid Number.
resultNamestringNoText representation of the call result.
hangupDirectionIdintNoID indicating which party ended the call.
hangupDirectionNamestringNoText representation of the hang-up direction.
endTimedatetimeNoEnd time of the call. Returns null if unavailable.
answerTimedatetimeNoTime the call was answered. Returns null if it was not answered.
callDurationSecondsdoubleNoCall duration (seconds). Returns null if unavailable.
queueWaitSecondsintNoTime spent waiting in the queue (seconds).
personnelIdstringNoID of the agent who handled the call. Returns null if unavailable.
personnelNamestringNoName of the agent who handled the call.
agentIdstringNoID of the AI agent that handled the call. Returns null if unavailable.
agentNamestringNoName of the AI agent that handled the call.
analysisarrayNoExtended analysis parameters. Returned as an empty array unless includeAnalysis: true is sent in the request body. When populated, each item has the form { key (snake_case), friendlyName (label), value }.
metadataobjectNoThe metadata sent with the Start Call request that initiated the call, returned as-is. null if no metadata was sent.
recordUrlstringNoDownload URL of the call recording. Send a GET request with a Bearer token; opening it in a browser returns 401. See the Call Recording page for details.
totalResultCountintNoTotal number of matching records.
totalPageCountintNoTotal number of pages.

For the steps to download the recording using recordUrl, see the Call Recording page.

Data Security and Masking

The following information is masked in the call title (title), summary (summary) and new request text (newRequestInfo):

DataBehavior
Phone numberReturned as [MASKED] if it appears in text fields. The customer’s number is returned only in the customerPhoneNumber field.
EmailReturned as [MASKED]
National ID (TCKN)Returned as [MASKED]

The callId field is the call’s own identifier and is not considered sensitive data like a phone number — it is returned as plain text in the response.

Last updated: