---
title: "List of calls including the detail record"
method: GET
path: "/call/detail"
tags: ["call"]
---

# List of calls including the detail record

`GET /call/detail`

Retrieves call records with extended detail fields beyond the basic call list. Returns comprehensive call data including duration, cost, routing path, recording URLs, transcription data, custom fields, tags, and campaign information. Supports pagination and advanced filtering.

## Query parameters

- `limit` integer
- `offset` integer
- `filter` string[]
- `recordURL` boolean
- `fetchComment` boolean

## Response `200`

Call records with detailed metadata, recordings, transcriptions, and custom fields

- CallDetailResponse[]
  - `call_id` integer — Unique identifier for the call record. Integer. Use as the primary key when cross-referencing other endpoints (e.g., /call/transcription, /call/tag).
  - `call_flow_id` integer, required — Unique identifier for the call flow/route definition the call was answered by. Integer. Maps to call_flow.call_flow_id.
  - `group_id` integer, required — Organization unit (group) ID the call/record belongs to. Integer. Used to scope data; see /group/list for available group IDs.
  - `disposition` 'ANSWERED' | 'BUSY' | 'FAILED' | 'NO ANSWER' | 'NONE' | 'HANGUP' — Call outcome classification. Enum: ANSWERED, BUSY, FAILED, NO ANSWER, NONE, HANGUP. Default NONE. Set by carrier response plus in-call behavior.
  - `duration` integer — Total call length in seconds (integer). Includes the entire connected segment from answer to hangup.
  - `caller_id` string, required — Phone number of the originating caller. String of digits, typically 10 digits for US numbers (e.g., '2025550123').
  - `tracking_number` string, required — Phone number the caller dialed (the tracking/DNI number). Convirza routes calls from this number through the configured call flow. String of digits.
  - `ring_to` string, required — Phone number the call was ultimately forwarded to (the agent/business line). String of digits.
  - `default_ring_to` string — Default ring-to number configured on the call flow (before any dynamic routing). String of digits.
  - `repeat_call` boolean — Boolean. True if this caller has previously called a tracking number in this account. Default false.
  - `call_started` string, date-time, required — Timestamp when the call started. ISO 8601 date-time with timezone (e.g., '2024-03-01T14:22:10.000-07:00').
  - `ai_caller_identity` string — The name of the caller associated with the caller ID. Type: string.
  - `bill_second` integer — Billable call duration rounded up to the nearest 30-second interval. Integer, in seconds.
  - `external_id` string — Customer-provided identifier used to map this call to a record in the customer's own system. String. Must be unique within the customer's org.
  - `recording_file` string — Filename of the call recording in Convirza's storage. String. Use recordURL=true to also fetch a signed download URL.
  - `call_value` integer — Monetary value assigned to the call by scoring/analytics. Integer (cents or whole dollars depending on account config).
  - `dni_log_id` string — UUID string referencing the DNI session that produced this call. Use /call/dni to fetch the full session details.
  - `is_outbound` boolean — Boolean. True if the call was placed by an agent/voice-agent outbound; false for inbound.
  - `is_spam` boolean — Indicates if the call is marked as spam
  - `call_mine_status` 'not mined' | 'mined' | 'pending' | 'cancel' | 'none' — Lifecycle state of the transcription/mining process. Enum: 'not mined', 'mined', 'pending', 'cancel', 'none'. Note: exact transition rules undocumented; see TEST-9.6.
  - `cdr_source` 'CE' | 'API' | 'BVR' | 'NONE', required — Source that generated the Call Detail Record. Enum: CE (Convirza carrier engine), API (uploaded via /call/upload), BVR (legacy voice response), NONE.
  - `call_ended` string, date-time, required — Timestamp when the call ended. ISO 8601 date-time with timezone.
  - `call_created` string, date-time — Timestamp when the call record was persisted in Convirza. ISO 8601 date-time. May trail call_started if the record was uploaded later via API.
  - `mined_timestamp` string, date-time — Timestamp when the call audio was processed through Convirza's ASR (transcription) pipeline. ISO 8601 date-time. Null if the call has not yet been mined.
  - `ring_to_name` string — Name associated with the ring-to phone number (agent name). String.
  - `analytic_status` string — Lifecycle state of the conversation analytics (scoring) process. String, values include states like 'pending', 'complete'. Exact enum and transitions undocumented; see TEST-9.6.
  - `channel_id` integer — Unique identifier for the marketing channel tagged on this call. Integer. See /misc/channel for available channels.
  - `channel_category` string — Top-level marketing channel category (e.g., 'Paid Search', 'Organic', 'Social').
  - `channel_sub_category` string — Sub-category within the parent channel (e.g., 'Google', 'Bing').
  - `channel` string — Human-readable channel label derived from category + sub_category (e.g., 'Paid Search - Google').
  - `comments` object[] — comments. Type: array of object.
    - `comment_id` integer — The unique identifier for the comment. Type: integer (int32).
    - `call_id` string — Unique identifier for the call record. Integer. Use as the primary key when cross-referencing other endpoints (e.g., /call/transcription, /call/tag).
    - `comment_text` string — All comments associated with call. Type: string.

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/convirza/apis/convirza-apis.md) · [All operations](https://skmtc.net/convirza/apis/convirza-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convirza/convirza-apis/revisions/ccf9bbe34f5a/schema)