List Tags

GET

https://platform-api.convirza.com/v3/tag/{org_unit_id}

Miscellaneous

Last modified:2026-04-03 14:27:57

Returns a paginated list of call tags available within the specified organizational unit.

What tags are used for
Tags are labels applied to call records by agents or automated rules to categorize call outcomes, topics, and quality indicators. Examples: "Lead", "Appointment Booked", "Complaint", "Follow-up Required".

Tag types

user — custom tags created by account admins for their specific workflows.

system — platform-level tags applied automatically by Convirza (e.g. disposition tags).

all (default) — return both user and system tags.

Filtering and sorting

search — partial, case-insensitive search against the tag name.

sort — field to sort on: tag_name (alphabetical) or call_count (most-used first).

direction — ASC or DESC (default: ASC).

Pagination
Uses 0-based page indexing. page=0, limit=100 returns the first 100 tags.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Successfully retrieved tags list

Body

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://platform-api.convirza.com/v3/tag/?search&sort&tag_type&status&offset&limit&direction' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Success",
    "data": {
        "tags": [
            {
                "tag_id": 123,
                "tag_name": "Sales Lead",
                "org_unit_id": 70035,
                "call_count": 42,
                "editable": true
            },
            {
                "tag_id": 124,
                "tag_name": "Customer Service",
                "org_unit_id": 70035,
                "call_count": 18,
                "editable": false
            }
        ],
        "total": 45
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-01-20T12:34:56.789Z"
}

Modified at 2026-04-03 14:27:57

List Industries

Create Tag