CAcarecycle
Calls

Get All Calls

Get paginated calls for authenticated client with descriptive field names

get/v2/calls

Request

  • Base URL
    https://api.carecycle.ai
  • URL
    https://api.carecycle.ai/v2/calls
  • Auth
    API key in header x-api-key

Query parameters

pagenumber

GET /v2/calls Parameter

perPagenumber

GET /v2/calls Parameter

sortBy'createdAt' | 'callerId' | 'direction' | 'assistantType' | 'duration' | 'disposition' | 'customerName' | 'campaignName' | 'agentName' | 'sourceName'

GET /v2/calls Parameter

sortDirection'asc' | 'desc'

GET /v2/calls Parameter

sortCustomFieldKeystring

GET /v2/calls Parameter

customFieldKeysstring

GET /v2/calls Parameter

searchstring

Search query: matches customer name, phone number, or disposition

customerIdstring uuid

Filter calls by customer ID for exact customer call history

campaignIdsstring

Optional array of campaign IDs to filter calls by specific campaigns (comma-separated string)

agentUserIdsstring

Optional array of agent user IDs to filter calls by specific softphone agents (comma-separated string)

durationOperator'<=' | '>='

Duration filter operator (less than or equal, greater than or equal)

durationValuenumber

Duration value in seconds to filter by

direction'inbound' | 'outbound'

Filter by call direction

callType'voice_ai' | 'softphone'

Filter by call type: Voice AI or Softphone

startDatestring date-time

Start date-time for call range filtering. ISO 8601 timestamp

endDatestring date-time

End date-time for call range filtering. ISO 8601 timestamp

excludeDispositionsstring

Array of disposition names to exclude from results (comma-separated string)

includeDispositionsstring

Array of disposition names to limit results to (comma-separated string). Combines with excludeDispositions when both are sent.

excludeSourcesstring

Array of source ids to exclude from results (comma-separated string)

includeTestCalls'true' | 'false'

When true, test calls are included in results. Default behavior is to exclude test calls.

connectedCallsOnly'true' | 'false'

Filter for connected calls only using disposition outcome types, with a legacy name fallback. Default behavior is to include all calls.

includeErrorDispositions'true' | 'false'

Deprecated compatibility parameter. Error dispositions are always excluded, regardless of this value.

includeTotal'true' | 'false'

When false, skips the exact count so the page can return independently. Use GET /v2/calls/count for the total.

Response

GET /v2/calls Positive response

itemsTotalnumber required
currentPagenumber required
nextPagenumber nullable required
prevPagenumber nullable required
hasNextPageboolean required
totalExactboolean required
testNumberCallsnumber

Count of test number calls in the response

hasSourceTrackingboolean

Whether any campaigns have source tracking enabled

Changes

No recorded changes to this operation across all 2 revisions of this API.