--- title: "List of calls with DNI data associated to call" method: GET path: "/call/dni" tags: ["call"] --- # List of calls with DNI data associated to call `GET /call/dni` Retrieves call records with Dynamic Number Insertion (DNI) web tracking data. Returns calls along with associated visitor session information including browser details, IP addresses, referrer URLs, landing pages, and other web analytics for marketing attribution. Supports pagination and filtering. ## Query parameters - `limit` integer - `offset` integer - `filter` string[] ## Response `200` Call records with DNI session data and web visitor tracking information - CallDNIResponse[] - `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'). - `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)