calls

List Calls

Retrieve a paginated list of calls across your whole company, including calls logged on projects, opportunities and accounts. Each call has projectId, opportunityId or accountId set to the record it's logged on (all three are null for calls not yet linked to a record).

Supports:

  • Pagination (page_size, page)
  • Date filtering (updated_after, updated_before)
  • Filtering by outcome, reason and disposition
  • Sorting by creation time (order_by, newest first by default)
get/calls

Request

  • Base URL: https://api.coperniq.io/v1
  • URL: https://api.coperniq.io/v1/calls
  • Auth: API key in header x-api-key

Query parameters

page_sizeinteger

Number of items per page (max 100)

pageinteger

Page number (1-based)

string date
OR
string date-time

Filter items updated after this timestamp (ISO 8601). Also matches records whose custom property values changed within the window.

string date
OR
string date-time

Filter items updated before this timestamp (ISO 8601). Also matches records whose custom property values changed within the window.

order_by'asc' | 'desc'

Sort by creation time. Defaults to newest first.

outcome'ANSWERED' | 'MISSED' | 'VOICEMAIL'

Only return calls with this outcome

reasonstring

Only return calls with exactly this reason (see GET /calls/classification-options)

dispositionstring

Only return calls with exactly this disposition (see GET /calls/classification-options)

Response

List of calls

idinteger required

Call identifier

fromNumberstring required

Phone number that initiated the call

toNumberstring required

Phone number that received the call

isInboundboolean required

Whether the call was inbound (true) or outbound (false)

outcome'ANSWERED' | 'MISSED' | 'VOICEMAIL'

Call outcome

startTimestring date-time nullable

When the call started

endTimestring date-time nullable

When the call ended

reasonstring nullable

Why the call happened. Company-defined: the value is the name of one of the company's call reasons (see GET /calls/classification-options?type=REASON), so it can be any string up to 255 characters. Default reasons are Product, Process, Service, Accounting, Revenue opportunity, Feedback and Other. Calls logged before custom reasons existed hold the legacy uppercase value (e.g. SERVICE).

dispositionstring nullable

How the call ended up. Company-defined: the value is the name of one of the company's call dispositions (see GET /calls/classification-options?type=DISPOSITION), so it can be any string up to 255 characters. Default dispositions are Info provided, Visit scheduled, Issue resolved, Follow up, Escalation, No action, Unresponsive and Other. Calls logged before custom dispositions existed hold the legacy uppercase value (e.g. INFO_PROVIDED).

notestring nullable

Human-editable note about the call. May contain HTML.

summarystring nullable

AI-generated summary of the call. null when the call has no AI transcript.

transcriptTextstring nullable

AI transcript of the call as plain text, one sentence per line in spoken order. null when the call has no AI transcript.

recordingUrlstring nullable

URL to the call recording

transcriptUrlstring nullable

URL to an externally hosted call transcript, if one was provided when the call was logged. For Coperniq phone calls use transcriptText.

missedCountinteger nullable

Number of times the call was missed

classificationNotestring nullable

For calls classified by Coperniq AI, the AI's explanation of why it chose the reason and disposition.

resolution'RESOLVED' | 'ESCALATED' | 'UNRESOLVED'

For calls handled by a Coperniq AI agent, whether the caller's issue was resolved.

createdAtstring date-time required

Creation timestamp

updatedAtstring date-time required

Last update timestamp

projectIdinteger nullable

The project this call is logged on, if it's on a project

opportunityIdinteger nullable

The opportunity this call is logged on, if it's on an opportunity

accountIdinteger nullable

The account this call is logged on, if it's on an account

Changes

No recorded changes to this operation across all 1 revision of this API.