Search incoming calls only
GET
/incoming-calls/search
/calls/search which also scans outbound calls. Returns matchedFields per result showing which columns hit the query. Soft-deleted calls are excluded.Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/incoming-calls/search?query=&limit=&offset=' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"calls": [
{
"id": "string",
"userId": "string",
"phoneNumberFrom": "string",
"createdAt": "2019-08-24T14:15:22.123Z",
"title": "string",
"callerName": "string",
"status": "FINISHED",
"minutesUsed": 0,
"transactions": [
{
"minutes": 0,
"type": "string",
"createdAt": "2019-08-24T14:15:22.123Z",
"description": "string"
}
],
"recordingUrl": "string",
"userRating": true,
"reviewedAt": "2019-08-24T14:15:22.123Z",
"finalSummary": "string",
"roleplayTranscript": [
{
"from": "ai",
"text": "string",
"metadata": {
"tone": "string",
"emotion": "string",
"language": "string",
"sentiment": "string"
},
"timestamp": 0
}
],
"transcript": "string",
"agent": {
"id": "string",
"name": "string",
"description": "string",
"avatar": "string",
"isPublic": true,
"isActive": true,
"instructions": "string",
"incomingCallInstructions": "string",
"maxIncomingCallDurationMinutes": 0,
"maxOutgoingCallDurationMinutes": 0,
"gatheringInformationOnIncomingCall": true,
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z",
"deletedAt": "2019-08-24T14:15:22.123Z",
"userId": "string",
"tools": [
{
"agentId": "string",
"toolId": "string",
"createdAt": "2019-08-24T14:15:22.123Z",
"tool": {
"id": "string",
"name": "string",
"description": "string",
"instruction": "string",
"toolType": "HTTP",
"url": "string",
"method": "GET",
"headers": {
"Authorization": "Bearer token123",
"Content-Type": "application/json"
},
"mcpServerUrl": "string",
"mcpServerHeaders": {},
"mcpServerName": "string",
"mcpToolName": "string",
"codeLanguage": "PYTHON",
"codeSource": "string",
"codeTestCases": {},
"inputSchema": {
"name": "string",
"type": "string",
"description": "string",
"children": [
{
"name": "query",
"type": "string",
"description": "Search query",
"validations": {
"required": true,
"min": 1,
"max": 100
},
"label": "Search Query"
},
{
"name": "category",
"type": "enum",
"description": "Category filter",
"enumValues": [
"news",
"weather",
"sports"
],
"validations": {
"required": false
}
}
],
"enumValues": [
"string"
],
"validations": {
"required": true,
"min": 0,
"max": 0,
"regex": "string",
"custom": "string",
"default": "string"
},
"label": "string",
"calculatedField": {
"dependencies": [
"string"
],
"formula": "string"
}
},
"isActive": true,
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z"
}
}
],
"accessToKnowledge": true,
"knowledgeAccessMode": "NONE",
"knowledgeAccessTags": [
"string"
],
"allowFollowUps": true,
"followUpInstructions": "string",
"includePrivateData": true,
"useBusinessProfile": true,
"useDetachedReceptionistProfile": true,
"receptionistPreferredName": "string",
"receptionistCompanyName": "string",
"receptionistCompanyWebsite": "string",
"receptionistCompanyDescription": "string",
"receptionistCompanyIndustry": "string",
"receptionistAddress": "string",
"receptionistCityName": "string",
"receptionistStateName": "string",
"receptionistZipCode": "string",
"receptionistTimezone": "string",
"voice": "string",
"modelName": {},
"allowCallTransfer": true,
"callTransferNumber": "string",
"transferHours": {
"MONDAY": [
900,
1730
],
"TUESDAY": [
900,
1730
],
"WEDNESDAY": [
900,
1730
],
"THURSDAY": [
900,
1730
],
"FRIDAY": [
900,
1730
]
},
"firstMessage": "string",
"allowOutboundGreetingInterruptions": false,
"enableVoiceExpressions": true,
"closingPhrase": "string",
"delayAcceptSeconds": 0,
"voiceRecognition": "EN",
"temperature": 0,
"dataCollections": [
{
"dataIdentifier": "string",
"description": "string",
"dataType": "STRING",
"id": "string",
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z",
"agentId": "string",
"results": [
{
"id": "string",
"dataCollectionId": "string",
"callId": "string",
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z",
"dataValue": {
"property1": "string",
"property2": "string"
}
}
]
}
],
"evaluations": [
{
"name": "string",
"prompt": "string",
"id": "string",
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z",
"agentId": "string",
"results": [
{
"id": "string",
"callId": "string",
"evaluationId": "string",
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z",
"type": "SUCCESS",
"rationale": "string"
}
]
}
],
"welcomingVoiceMailMessageForContacts": "string",
"welcomingVoiceMailMessageForOthers": "string",
"isVoiceMailAgent": false,
"outgoingCallFlow": {
"nodes": [
{}
],
"edges": [
{}
]
},
"incomingCallFlow": {
"nodes": [
{}
],
"edges": [
{}
]
},
"voiceSpeed": 0.5,
"incomingCallTypingSound": true,
"incomingCallBackgroundSound": true,
"outgoingCallBackgroundSound": true,
"outgoingCallTypingSound": true,
"allowIncomingSms": false,
"incomingSmsInstructions": "",
"autoRespondToSms": true,
"smsResponseDelay": 1,
"useSmsIncomingCallFlow": false,
"postCallSmsMessage": "string",
"allowRealtimeSms": false,
"phoneNumbers": [
{
"id": "string",
"createdAt": "2021-01-01T00:00:00Z",
"updatedAt": "2021-01-01T00:00:00Z",
"phoneNumber": "+1234567890",
"country": "US",
"isActive": true,
"agent": {
"id": "string",
"name": "string"
},
"agentId": "123",
"direction": "INCOMING",
"isSharedOutbound": false,
"provider": "TWILIO",
"source": "RENTED",
"readyToRelease": false,
"markedReadyToReleaseAt": "2019-08-24T14:15:22.123Z",
"markToDeleteAt": "2019-08-24T14:15:22.123Z",
"lastBilledAt": "2019-08-24T14:15:22.123Z",
"monthlyCost": "1.15",
"isTestNumber": false
}
],
"emailAddress": {
"address": "string",
"status": "ACTIVE"
},
"requireDataConsent": false,
"dataConsentText": "string",
"enablePostCallActions": false,
"postCallActionInstructions": "string",
"behaviorPreset": "default",
"strictSpamFilter": false,
"valuableCallRule": "string",
"overrideCallerId": "string"
},
"phoneNumberTo": {
"id": "string",
"createdAt": "2021-01-01T00:00:00Z",
"updatedAt": "2021-01-01T00:00:00Z",
"phoneNumber": "+1234567890",
"country": "US",
"isActive": true,
"agent": {
"id": "string",
"name": "string"
},
"agentId": "123",
"direction": "INCOMING",
"isSharedOutbound": false,
"provider": "TWILIO",
"source": "RENTED",
"readyToRelease": false,
"markedReadyToReleaseAt": "2019-08-24T14:15:22.123Z",
"markToDeleteAt": "2019-08-24T14:15:22.123Z",
"lastBilledAt": "2019-08-24T14:15:22.123Z",
"monthlyCost": "1.15",
"isTestNumber": false
},
"followUps": [
{
"id": "string",
"type": "SMS",
"content": "string",
"recipientEmail": "string",
"recipientPhone": "string",
"status": "PENDING",
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z",
"triggeredByCallId": "string"
}
],
"tasks": [
{
"id": "string",
"title": "string",
"description": "string",
"status": "TODO",
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z",
"dueDate": "2019-08-24T14:15:22.123Z",
"priority": "HIGH",
"leadNotes": "string",
"leadStatus": "string",
"tags": [
"string"
],
"isAiGenerated": true,
"completedAt": "2019-08-24T14:15:22.123Z",
"completedBy": "string"
}
],
"taskResults": [
{
"id": "string",
"slug": "string",
"title": "string",
"groupName": "string",
"status": "completed",
"reason": "string",
"createdAt": "2019-08-24T14:15:22.123Z"
}
],
"dataCollections": [
{
"id": "string",
"agentId": "string",
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z",
"deletedAt": "2019-08-24T14:15:22.123Z",
"dataType": "STRING",
"dataIdentifier": "string",
"description": "string"
}
],
"evaluations": [
{
"id": "string",
"agentId": "string",
"createdAt": "2019-08-24T14:15:22.123Z",
"updatedAt": "2019-08-24T14:15:22.123Z",
"deletedAt": "2019-08-24T14:15:22.123Z",
"name": "string",
"prompt": "string"
}
],
"recommendedNextAction": "string",
"testCall": false,
"isFavorite": false,
"isSpam": true,
"callInterceptedByUser": false,
"shareHash": "string",
"matchedFields": [
"phone",
"summary",
"title",
"caller"
],
"bookings": [
{
"id": "string",
"title": "string",
"description": "string",
"startTime": "2019-08-24T14:15:22.123Z",
"endTime": "2019-08-24T14:15:22.123Z",
"durationMinutes": 0,
"guestPhone": "string",
"guestEmail": "string",
"guestName": "string",
"sourceType": "INBOUND_CALL",
"calendarProvider": "GOOGLE",
"externalEventUrl": "string",
"timezone": "string",
"createdAt": "2019-08-24T14:15:22.123Z"
}
],
"notes": "string",
"contactId": "123e4567-e89b-12d3-a456-426614174000"
}
],
"total": 0
}Modified at 2026-07-23 18:02:16