APICallsGet Calls

Get Calls

Fetch a paged list of calls in your organization. Transcript and summary are not included here (use Get Call by ID); hasTranscript and hasSummary show whether they exist. Recording URLs are pre-signed and expire. Filters: direction (inbound | outbound | web | voicemail | no-answer | softphone), agentId, disposition, startDate and endDate (ISO dates), searchTerm, transcriptSearch, summarySearch, audited (audited | notAudited), favorites (true), excludeWebCalls (true), minDuration and maxDuration (seconds), batchId. Sort with sortField (default startTime) and sortDirection (asc | desc). pageSize defaults to 50, max 500.

Created: April 18, 2025

Updated: September 16, 2026

Overview

GET

https://dashboard.vinsi.ai/api/calls

Request

Headers

Content-Type

string

application/json

x-api-key

string

REQUIRED

Query Params

page

string

OPTIONAL

Example: 1

pageSize

string

OPTIONAL

Example: 50

direction

string

OPTIONAL

Example: inbound

agentId

string

OPTIONAL

Example: cmexampleagent000000000001

disposition

string

OPTIONAL

Example: Appointment Booked

startDate

string

OPTIONAL

Example: 2026-09-01

endDate

string

OPTIONAL

Example: 2026-09-16

searchTerm

string

OPTIONAL

Example: 5555550142

transcriptSearch

string

OPTIONAL

Example: cleaning

summarySearch

string

OPTIONAL

Example: appointment

audited

string

OPTIONAL

Example: notAudited

favorites

string

OPTIONAL

Example: false

excludeWebCalls

string

OPTIONAL

Example: false

minDuration

string

OPTIONAL

Example: 30

maxDuration

string

OPTIONAL

Example: 600

batchId

string

OPTIONAL

Example:

sortField

string

OPTIONAL

Example: startTime

sortDirection

string

OPTIONAL

Example: desc

Response

{3 items"calls":[1 item0:{45 items"id":string"c_1757964000123"
"agentName":string"Front Desk Agent"
"agentNameRaw":string"Front Desk Agent"
"softphone":boolfalse
"callerUserName":null
"callerUserEmail":null
"agentId":string"cmexampleagent000000000001"
"incomingPhone":string"+15555550142"
"outgoingPhone":string"+15555550199"
"contact":{3 items"id":int1042
"name":string"Alex Morgan"
"phone":string"+15555550142"
}
"variables":{}0 items
"duration":int94
"disposition":string"Appointment Booked"
"dispositions":[3 items0:string"Appointment Booked"
1:string"Callback Requested"
2:string"Not Interested"
]
"startTime":string"2026-09-15T18:02:11.000Z"
"endTime":string"2026-09-15T18:03:45.000Z"
"status":string"completed"
"recordingUrl":string"https://example-bucket.s3.amaz..."
"completeRecordingUrl":null
"transcript":null
"summary":null
"hasTranscript":booltrue
"hasSummary":booltrue
"audited":boolfalse
"auditedBy":null
"auditedByEmail":null
"auditedByName":null
"auditedAt":null
"favorite":boolfalse
"favoriteBy":null
"favoriteByEmail":null
"favoriteByName":null
"favoriteAt":null
"callScore":null
"callScoreNotes":null
"scoredAt":null
"scoredBy":null
"scoredByEmail":null
"scoredByName":null
"number":int48213
"comments":null
"batchId":null
"call_type":string"inbound"
"error":null
"data":{}0 items
}
]
"pagination":{12 items"page":int1
"pageSize":int50
"total":int1
"totalPages":int1
"hasMore":boolfalse
"totalInbounds":int1
"totalOutbounds":int0
"totalWebs":int0
"totalVoicemails":int0
"totalSoftphones":int0
"totalNoAnswer":int0
"grandTotal":int1
}
"filters":{8 items"direction":string"inbound"
"agentId":string"cmexampleagent000000000001"
"startDate":string"2026-09-01"
"endDate":string"2026-09-16"
"sortField":string"startTime"
"sortDirection":string"desc"
"favorites":boolfalse
"excludeWebCalls":boolfalse
}
}

Endpoint Explorer

Note: You must be already authenticated on https://dashboard.vinsi.ai/ to use this API tester.

GET

Headers

Content-Type: *

x-api-key: *

Query Params

page: *

pageSize: *

direction: *

agentId: *

disposition: *

startDate: *

endDate: *

searchTerm: *

transcriptSearch: *

summarySearch: *

audited: *

favorites: *

excludeWebCalls: *

minDuration: *

maxDuration: *

batchId: *

sortField: *

sortDirection: *

Response

No response yet. Click Send to test the API.