---
title: "List of calls with tags associated to call"
method: GET
path: "/call/tag"
tags: ["call"]
---

# List of calls with tags associated to call

`GET /call/tag`

Retrieves call records with associated tags. Returns call metadata including all tags assigned to each call for categorization and filtering purposes. Supports pagination and filtering.

## Query parameters

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

## Response `200`

An array of calls with call detail

- CallTagResponse
  - `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').
  - `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.

## Other responses

- `default` — Unexpected error

---

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