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

# List of calls including the detail record

`GET /call/extend`

Retrieves call records with additional extended fields and analytics data beyond standard call details. Returns enhanced call information including advanced metrics, conversation intelligence data, and enriched routing information. Supports pagination and filtering.

## Query parameters

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

## Response `200`

Call records with extended analytics and enriched metadata

- CallExtendResponse
  - `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.
  - `extended` Extend
    - `id` string — id. Type: string.
    - `is_valid` boolean — is_valid. Type: boolean.
    - `country_calling_code` string — country_calling_code. Type: string.
    - `line_type` string — line_type. Type: string.
    - `carrier` string — carrier. Type: string.
    - `is_prepaid` boolean — is_prepaid. Type: boolean.
    - `is_commercial` boolean — is_commercial. Type: boolean.
    - `belongs_to` object[] — belongs_to. Type: array of object.
      - `id` string — id. Type: string.
      - `name` string — name. Type: string.
      - `firstname` string — firstname. Type: string.
      - `middlename` string — middlename. Type: string.
      - `email` string — email. Type: string.
      - `home_value` integer — home_value. Type: integer (int32).
      - `income` integer — income. Type: integer (int32).
      - `lastname` string — lastname. Type: string.
      - `alternate_names` string[] — alternate_names. Type: array of string.
      - `age_range` string — age_range. Type: string.
      - `gender` string — gender. Type: string.
      - `type` 'Person' | 'Business' — type. Type: enum (string); Allowed values: Person, Business.
      - `industry` string — industry. Type: string.
      - `link_to_phone_start_date` string, date — link_to_phone_start_date. Type: string (date).
    - `current_addresses` object[] — current_addresses. Type: array of object.
      - `id` string — id. Type: string.
      - `location_type` string — location_type. Type: string.
      - `street_line_1` string — street_line_1. Type: string.
      - `street_line_2` string — street_line_2. Type: string.
      - `city` string — Caller's city (from caller-ID/location lookup). String.
      - `postal_code` string — postal_code. Type: string.
      - `zip4` string — zip4. Type: string.
      - `state_code` string — state_code. Type: string.
      - `country_code` string — country_code. Type: string.
      - `lat_long` object — lat_long.
        - `latitude` number — latitude. Type: number.
        - `longitude` number — longitude. Type: number.
        - `accuracy` string — accuracy. Type: string.
      - `is_active` boolean — is_active. Type: boolean.
      - `delivery_point` string — delivery_point. Type: string.
      - `link_to_person_start_date` string, date — link_to_person_start_date. Type: string (date).
      - `link_to_person_end_date` string — link_to_person_end_date. Type: string.
    - `historical_addresses` object[] — historical_addresses. Type: array of object.
      - `id` string — id. Type: string.
      - `location_type` string — location_type. Type: string.
      - `street_line_1` string — street_line_1. Type: string.
      - `street_line_2` string — street_line_2. Type: string.
      - `city` string — Caller's city (from caller-ID/location lookup). String.
      - `postal_code` string — postal_code. Type: string.
      - `zip4` string — zip4. Type: string.
      - `state_code` string — state_code. Type: string.
      - `country_code` string — country_code. Type: string.
      - `lat_long` object — lat_long.
        - `latitude` number — latitude. Type: number.
        - `longitude` number — longitude. Type: number.
        - `accuracy` string — accuracy. Type: string.
      - `is_active` boolean — is_active. Type: boolean.
      - `delivery_point` string — delivery_point. Type: string.
      - `link_to_person_start_date` string, date — link_to_person_start_date. Type: string (date).
      - `link_to_person_end_date` string — link_to_person_end_date. Type: string.
    - `associated_people` object[] — associated_people. Type: array of object.
      - `id` string — id. Type: string.
      - `name` string — name. Type: string.
      - `firstname` string — firstname. Type: string.
      - `middlename` string — middlename. Type: string.
      - `lastname` string — lastname. Type: string.
      - `relation` string — relation. Type: string.
    - `alternate_phones` string[] — alternate_phones. Type: array of string.
    - `emails` string[] — emails. Type: array of string.
    - `error` object — error.
      - `name` string — name. Type: string.
      - `message` string — SMS message body. String. Max length set by carrier (typically 160 chars for single-segment, up to 1600 for concatenated).
    - `warnings` string[] — warnings. Type: array of 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)
