---
title: "Get Call by ID"
method: GET
path: "/v2/calls/{id}"
tags: ["Calls"]
---

# Get Call by ID

`GET /v2/calls/{id}`

## Request

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

Get single call by ID with full details

## Path parameters

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

## Response `200`

GET /v2/calls/:id Positive response

- GetV2CallsIdPositiveResponse: Call
  - `id` string, uuid, required
  - `disposition` string, nullable, required
  - `callerId` string, nullable, required
  - `testFlag` boolean, nullable, required
  - `campaignId` string, uuid, nullable, required
  - `transferConfigId` string, uuid, nullable, required
  - `twilioSid` string, nullable, required
  - `service` 'vapi' | 'mobius' | 'softphone' | 'campaign_test' | 'null', nullable, required
  - `campaignName` string, nullable, required
  - `campaignIsReceptionist` boolean, required
  - `agentName` string, nullable, required
  - `customerId` string, nullable, required
  - `customerName` string, nullable, required
  - `customerStatus` 'Lead' | 'Active' | 'Inactive' | 'null', nullable, required
  - `createdAt` string, date-time, required: Call creation time. ISO 8601 timestamp
  - `duration` string, required: Formatted duration like '2m 30s'
  - `assistantType` string, nullable, required
  - `successEvaluation` string, nullable, required
  - `summary` string, nullable, required
  - `transcript` string, nullable, required
  - `detectionFlags` object, nullable, required
    - `appointment` object, nullable, required
      - `detected` boolean, nullable, required
      - `confidence` 'low' | 'medium' | 'high' | 'null', nullable, required
    - `inquiry` object, nullable, required
      - `detected` boolean, nullable, required
      - `confidence` 'low' | 'medium' | 'high' | 'null', nullable, required
    - `dnc` object, nullable, required
      - `detected` boolean, nullable, required
      - `confidence` 'low' | 'medium' | 'high' | 'null', nullable, required
  - `direction` 'inbound' | 'outbound' | 'null', nullable, required
  - `sourceName` string, nullable, required
  - `attemptNumber` number, nullable, required
  - `ourPhoneNumber` string, nullable, required
  - `customFields` object[], required: Custom fields from the customer associated with this call
    - `fieldKey` string, required: Generated identifier for the field
    - `fieldLabel` string, required: Display name shown to users
    - `fieldDescription` string, required: Description of the field's purpose
    - `fieldType` 'text' | 'number' | 'boolean' | 'date' | 'select' | 'multi_select', required: Type of data this field stores
    - `isRequired` boolean, nullable, required: Whether this field must have a value
    - `options` string[], nullable, required: Available options for select/multi-select fields
    - `validationRules` union, required: Validation rules for the custom field
      - string
      - number
      - boolean
      - object
      - unknown[]
        - unknown
    - `value` union, required: The actual value for this customer (type determined by fieldType). Dates are represented as ISO 8601 strings.
      - string
      - number
      - boolean
      - string[]
  - `participationEvents` object[], required: Softphone participation timeline: agents joining/leaving and participants added mid-call. Empty for single-agent and voice-AI calls.
    - `event` 'call_answered' | 'agent_joined' | 'agent_left' | 'participant_added' | 'call_ended' | 'audio_clip_played', required
    - `timestamp` string, date-time, required: Participation event time. ISO 8601 timestamp
    - `endedBy` 'customer' | 'agent'
    - `userId` string
    - `userName` string
    - `byUserId` string
    - `byUserName` string
    - `phoneNumber` string
    - `transferConfigId` string
    - `destinationName` string
    - `callContinued` boolean
    - `clipLabel` string
  - `transcriptEntries` object[]: Structured per-utterance transcript with speaker and timestamp. Only returned by the single-call endpoint, and only for softphone calls with a live transcript.
    - `speakerName` string, nullable
    - `speakerRole` string, nullable
    - `userId` string, nullable
    - `text` string, required
    - `timestamp` string, date-time, nullable: Transcript entry time. ISO 8601 timestamp
  - `routingResult` object
    - `outcome` string, required
    - `agentConnectedAt` string, nullable, required
    - `queuedAt` string, nullable, required
    - `fallbackReason` string, nullable, required
    - `fallbackAction` string, nullable, required
    - `terminationParty` 'caller' | 'platform' | 'not_reported', required
    - `callerEndedAfterFallback` boolean, required
    - `callbackOutcome` string, nullable, required
    - `callbackDecision` string, nullable, required
    - `callbackReason` string, nullable, required
    - `announcementCompleted` boolean, required
    - `deliveryStage` string, nullable, required
    - `trackingVersion` number, required
    - `availableAgents` number, nullable, required
  - `handoff` object: AI-to-rep warm handoff shared by both legs of the call: the AI leg, the rep leg it reached (if any), and how the handoff ended
    - `aiCallId` string, required
    - `aiDuration` string, required
    - `repCallId` string, nullable, required
    - `repName` string, nullable, required
    - `repDuration` string, nullable, required
    - `outcome` 'connected' | 'ringing' | 'no_answer' | 'caller_hung_up' | 'failed', required
    - `waitSeconds` number, nullable, required

## Other responses

- `400`: GET /v2/calls/:id Negative response 400
- `401`: GET /v2/calls/:id Negative response 401
- `403`: GET /v2/calls/:id Negative response 403
- `404`: GET /v2/calls/:id Negative response 404
- `409`: GET /v2/calls/:id Negative response 409
- `422`: GET /v2/calls/:id Negative response 422
- `429`: GET /v2/calls/:id Negative response 429
- `500`: GET /v2/calls/:id Negative response 500
- `502`: GET /v2/calls/:id Negative response 502
- `503`: GET /v2/calls/:id 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)