curl -X GET "https://api.contactship.ai/v1/tags" \
  -H "x-api-key: your-api-key"

const response = await fetch('https://api.contactship.ai/v1/tags', {
  headers: { 'x-api-key': 'your-api-key' },
});
const { data, count } = await response.json();
console.log(`${count} tags found`);

import requests

response = requests.get(
    'https://api.contactship.ai/v1/tags',
    headers={'x-api-key': 'your-api-key'},
)

result = response.json()
for tag in result['data']:
    print(f"{tag['name']} ({tag['color']}) — id: {tag['id']}")

{
  "data": [
    {
      "id": "tag-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "hot-lead",
      "color": "#FF5733",
      "label": "Hot Lead",
      "organization_id": "org-f1e2d3c4-b5a6-7890-1234-567890abcdef",
      "created_at": "2026-04-05T12:00:00Z"
    },
    {
      "id": "tag-b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "customer",
      "color": "#33FF57",
      "label": "Customer",
      "organization_id": "org-f1e2d3c4-b5a6-7890-1234-567890abcdef",
      "created_at": "2026-03-10T09:00:00Z"
    }
  ],
  "count": 2
}