Skip to main content
GET
/
tags
List all tags
curl --request GET \
  --url https://api.getfernand.com/tags \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": 42,
    "slug": "important-customer",
    "name": "Important Customer",
    "color": "#FF5733",
    "count_conversations": 15,
    "is_system": false
  }
]
Retrieves a list of all tags. Tags are returned sorted alphabetically by name. Each tag includes its color, slug, and the count of conversations it’s associated with.

Authorizations

​
X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Response

200 - application/json

List of tags retrieved successfully

​
id
integer<int32>
required

Unique identifier for the tag

Example:

42

​
slug
string
required

URL-friendly slug generated from the tag name

Maximum string length: 50
Example:

"important-customer"

​
name
string
required

Display name of the tag

Maximum string length: 50
Example:

"Important Customer"

​
color
string
required

Hex color code for the tag (e.g.,

Pattern: ^#[0-9A-Fa-f]{6}$
Example:

"#FF5733"

​
count_conversations
integer<int32>
required

Number of conversations associated with this tag

Example:

15

​
is_system
boolean
required

Whether this is a system-defined tag that cannot be modified or deleted

Example:

false