---
title: "Get paginated customer calls"
method: GET
path: "/v2/customers/{id}/calls"
tags: ["Customers"]
---

# Get paginated customer calls

`GET /v2/customers/{id}/calls`

## Request

- Base URL: `https://api.carecycle.ai`
- URL: `https://api.carecycle.ai/v2/customers/{id}/calls`
- Auth: API key in header `x-api-key`

List the calls you've had with a customer. Results come back one page at a time.

## Path parameters

- `id` string, uuid, required: Customer ID

## Query parameters

- `page` number
- `perPage` number
- `sortBy` 'createdAt' | 'disposition' | 'duration': Field to sort by
- `sortDirection` 'asc' | 'desc': Sort direction

## Response `200`

GET /v2/customers/:id/calls Positive response

- GetV2CustomersIdCallsPositiveResponse
  - `itemsTotal` number, required
  - `currentPage` number, required
  - `nextPage` number, nullable, required
  - `prevPage` number, nullable, required
  - `items` object[], required: List of call records for the customer
    - `id` string, uuid, required
    - `campaignId` string, uuid, nullable, required
    - `disposition` string, nullable, required
    - `callerId` string, nullable, required
    - `twilioSid` string, nullable, required
    - `service` 'vapi' | 'mobius' | 'softphone' | 'campaign_test' | 'null', nullable, required
    - `testFlag` boolean, nullable, required
    - `direction` 'inbound' | 'outbound' | 'null', nullable, required
    - `recordingUrl` string, nullable, required
    - `recordingId` string, nullable, required
    - `stereoRecordingUrl` string, nullable, required
    - `assistantType` string, nullable, required
    - `successEvaluation` string, nullable, required
    - `summary` string, nullable, required
    - `transcript` string, nullable, required
    - `durationMs` integer, nullable, required
    - `createdAt` string, date-time, required: Call creation time. ISO 8601 timestamp
    - `mainRecordingUrl` string, nullable, required
    - `isTestNumber` boolean, required: Indicates if the call was made to a test number
    - `sourceName` string, nullable, required
    - `agentId` string, nullable, required
    - `agentName` string, nullable, required

## Other responses

- `400`: GET /v2/customers/:id/calls Negative response 400
- `401`: GET /v2/customers/:id/calls Negative response 401
- `403`: GET /v2/customers/:id/calls Negative response 403
- `404`: GET /v2/customers/:id/calls Negative response 404
- `409`: GET /v2/customers/:id/calls Negative response 409
- `422`: GET /v2/customers/:id/calls Negative response 422
- `429`: GET /v2/customers/:id/calls Negative response 429
- `500`: GET /v2/customers/:id/calls Negative response 500
- `502`: GET /v2/customers/:id/calls Negative response 502
- `503`: GET /v2/customers/:id/calls Negative response 503

---

[API](https://skmtc.dev/carecycle/apis/carecycle-public-api.md) - [All operations](https://skmtc.dev/carecycle/apis/carecycle-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carecycle/apis/carecycle-public-api/revisions/db390c743c36?raw)