List All Tags

Retrieve a paginated list of tags defined in your workspace. Tags are used to categorize and segment contacts.

---

Endpoint

GET https://api.campaignlark.com/v1/tags

---

Query Parameters

Parameter	Type	Required	Default	Description
page	integer	optional	1	Page number.
limit	integer	optional	50	Items per page (1–100).

---

Sample Request

GET https://api.campaignlark.com/v1/tags?page=1&limit=50

---

Response

Success — 200 OK

{
  "data": {
    "tags": [
      {
        "id": 1,
        "name": "VIP",
        "description": "VIP customers"
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 50,
      "total_pages": 1,
      "total_count": 1
    }
  }
}

Tag Object

Field	Type	Description
id	integer	Unique identifier for the tag.
name	string	The tag name.
description	string	A short description of the tag.

Pagination Object

Field	Type	Description
current_page	integer	The current page number.
per_page	integer	Number of items per page.
total_pages	integer	Total number of pages.
total_count	integer	Total number of tags.