---
title: "Get Call Details"
method: GET
path: "/calling/call-details"
tags: ["calling"]
---

# Get Call Details

`GET /calling/call-details`

Retrieves detailed information about a specific call using its unique identifier. Use the send_analysis parameter to include analysis data in the response.

## Query parameters

- `id` string, required
- `send_analysis` boolean

## Headers

- `X-API-KEY` string, required

## Response `200`

Call details retrieved successfully.

- object
  - `status` string
  - `data` object
    - `id` string — The unique identifier of the call
    - `call_direction` 'inbound' | 'outbound' | 'webcall' — The direction of the call
    - `call_status` 'registered' | 'ongoing' | 'retry' | 'error' | 'completed' | 'failed' | 'cancelled' | 'forwarded' — The current status of the call
    - `call_sub_status` 'IN_DB' | 'QUEUED' | 'ACCEPTED' | 'RATE_LIMITED' | 'RETRY_LIMIT_REACHED' | 'RETRY_SCHEDULED' | 'FAILED' | 'USER_DID_NOT_JOIN' | 'USER_LEFT' | 'USER_BECAME_IDLE' | 'CAMPAIGN_TIME_EXCEEDED' | 'MAX_CALL_DURATION' | 'NOT_ABLE_TO_CALL' | 'USER_TERMINATED' | 'DND_SKIPPED' | 'VOICEMAIL_DETECTED' | 'VOICEMAIL_DETECTED_VIA_LLM' | 'PRE_CALL_API_FAILED' | 'RECONCILED_TO_ERROR_FROM_REGISTERED' | 'RECONCILED_TO_ERROR_FROM_RETRY' | 'RECONCILED_TO_ERROR_FROM_ONGOING' | 'RECONCILED_TO_COMPLETED_FROM_ONGOING' — The sub-status of the call providing more detail on the call outcome
    - `from_number` string — The phone number the call was made from
    - `to_number` string — The phone number the call was made to
    - `callee_name` string — The name of the person called
    - `agent_id` string — The ID of the agent that handled the call
    - `initiation_time` string, date-time — When the call was initiated
    - `recording_url` string — URL to the call recording. Valid for 24 hours after the call; download the recording within that window to retain it.
    - `transcription_url` object[] — Array of conversation turns between bot and user
      - `bot` string — Bot's message
      - `user` string — User's message
    - `platform_analysis` object — Platform-generated analysis of the call (only included when send_analysis=true)
    - `client_analysis` object — Client-specific analysis of the call (only included when send_analysis=true)

## Other responses

- `404` — Not Found - The call does not exist.
- `500` — Internal Server Error.

---

[API](https://skmtc.dev/ringg/apis/ringg-ai-api-documentation.md) · [All operations](https://skmtc.dev/ringg/apis/ringg-ai-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ringg/ringg-ai-api-documentation/revisions/00b614a7714c/schema)