---
title: "An array of calls"
method: GET
path: "/call/list"
tags: ["call"]
---

# An array of calls

`GET /call/list`

Retrieves call records matching specified filter criteria. Returns basic call information suitable for list views and reporting. Supports pagination, filtering by date range, campaign, group, caller ID, and other attributes.

## Query parameters

- `limit` integer
- `offset` integer
- `filter` string[]

## Response `200`

Call records matching filter criteria with basic metadata

- CallList[]
  - `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').
  - `campaign_id` integer — Unique identifier for the campaign this call was attributed to. Integer.

## 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)