List Tags

GET /external/v1/tags

Returns all tags in your account with their usage count (number of contacts carrying the tag).

Authentication

Requires tags:read permission.

Request

cURL

curl --request GET \
  --url "https://app.getraze.com/external/v1/tags" \
  --header "X-API-Key: YOUR_API_KEY"

Node.js

const axios = require('axios');

const response = await axios.get('https://app.getraze.com/external/v1/tags', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});

console.log(response.data);

Python

import requests

response = requests.get(
    'https://app.getraze.com/external/v1/tags',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

print(response.json())

Response

{
  "success": true,
  "data": [
    {
      "id": "tag_01",
      "name": "decision-maker",
      "color": "purple",
      "created_at": "2026-01-10T08:00:00Z",
      "usage_count": 42
    }
  ]
}

Response Fields

Field	Type	Description
id	string	Tag identifier
name	string	Tag name
color	string	Tag color
created_at	string	ISO 8601 creation timestamp
usage_count	integer	Number of contacts with this tag