--- title: "Returns a specific call record referenced by the ID given" method: GET path: "/call" tags: ["call"] --- # Returns a specific call record referenced by the ID given `GET /call` Retrieves detailed information for a specific call record by ID. Returns complete call metadata including duration, caller information, routing details, disposition, and associated campaign data. ## Query parameters - `id` integer, required ## Response `200` Complete call record with metadata, routing information, and campaign association - CallResponse - `result` string, required — Outcome of the request. String, typically 'success' or 'error'. - `err` string — Error message when result='error'. String. Empty/null on success. - `data` object, required — Response payload. Shape varies by endpoint. - `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. - `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. - `tags` Tag[] — tags. Type: array of object (Tag). - `tag_id` integer — Unique identifier for the tag definition. Integer. - `ct_user_id` integer — Convirza user ID (platform user). Integer. Primary key of ct_user table. - `call_tag_created` string, date-time — Timestamp when the tag was applied to the call. ISO 8601 date-time. - `tag_name` string, required — Client-defined tag label. String. Note: some production tags have leading/trailing whitespace. - `tag_created` string, date-time — Timestamp when the tag was created. ISO 8601 date-time. - `tag_active` boolean — Boolean. True if tag definition is currently active. - `indicators` Indicator[] — indicators. Type: array of object (Indicator). - `indicator_id` integer — Unique identifier for the conversation analytics indicator (scoring criterion). Integer. - `score_id` integer — Unique identifier for a score record (one per call per indicator). Integer. - `score_value` integer — Numeric score for this indicator on this call. Integer 0-99. Higher = stronger match (semantics vary by indicator). - `indicator_name` string — Human-readable name of the indicator. String. Known issue: some indicator_name values have leading/trailing whitespace (TEST-4.6). - `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. - `indicator_active` boolean — Boolean. True if the indicator is currently active/scored. - `indicator_created` string, date-time — Timestamp when the indicator definition was created. ISO 8601 date-time. - `dni_data` Dni - `browser` string — The type of browser used by the end user. Type: string. - `created_at` string, date-time — The date and time when the record was created. Type: string (date-time). - `custom_params` string — Additional custom parameters passed to request. Type: string. - `destination_url` string — The URL resource called in the request. Type: string. - `dni_vid` string — dni_vid. Type: string. - `first_page` string — The URL of the first page displayed when user first arrives. Type: string. - `ga_cid` string — Google Analytics customer tracking ID. Type: string. - `ip_host` string — The IP address of the user making the page request. Type: string. - `last_page` string — The URL of the last page before the user leaves. Type: string. - `location_details` object - `ip` string — The IP address of the user making the request. Type: string. - `country_code` string — The country code of where the user is located. Type: string. - `country_name` string — The full country name of the where the user is located. Type: string. - `region_code` string — The regional code of the where the user is located. Type: string. - `region_name` string — The full regional name of the where the user is located. Type: string. - `city` string — Caller's city (from caller-ID/location lookup). String. - `zipcode` string — The zipcode area of the where the user is located. Type: string. - `latitude` number, float — The geospatial horizontal location of the where the user is located. Type: number (float). - `longitude` number, float — The geospatial vertical location of the where the user is located. Type: number (float). - `metro_code` string — The metropolitan code of the where the user is located. Type: string. - `area_code` integer — The state area code of the where the user is located. Type: integer (int32). - `log_date` string, date-time — The date and time that the log record was recorded. Type: string (date-time). - `master_node_id` integer — The top level group ID. Type: integer (int32). - `group_id` integer — Organization unit (group) ID the call/record belongs to. Integer. Used to scope data; see /group/list for available group IDs. - `phone_number_details` object[] - `dni_id` string — Unique identifier for DNI record of number entry in this block. Type: string. - `phone_number` string — Phone number as a string of digits. Typically 10 digits for US numbers. - `element` string — The HTML element used for substitution replacement of phone number. Type: string. - `phone_number_id` integer — The unique identifier for the phone number. Type: integer (int32). - `pool_id` integer — The unique identifier for the associated number pool from which the number was pulled. Type: integer (int32). - `number_last_used` string, date-time — The date and time of the last time the phone number was used for this session. Type: string (date-time). - `provisioned_route_id` integer — The unique identifier for the route to which the number is associated. Type: integer (int32). - `ref_param` object - `utm_medium` string — Identifies medium. Type: string. - `utm_campaign` string — Identifies the campaign. Type: string. - `utm_content` string — The content used. Type: string. - `kw` string — The KW. Type: string. - `referring` string — The URL of the referring site. Type: string. - `referring_type` string — The source medium of the referrer. Type: string. - `referring_url` string — The URL of the referring site. Type: string. - `search_words` string — The search words used. Type: string. - `session_id` string — A unique identifier used to identify the users session. Type: string. - `updated_at` string, date-time — The date and time that the record was last updated. Type: string (date-time). ## 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/versions/ccf9bbe34f5a/schema)