List tags

GET/api/v2/contacts/tags

Returns all tags in your organization with how many contacts have each. Counts are exact up to 1,000.

Rate limit 300 requests per minute

Headers

  • x-api-keyheaderRequired

    Your API key.

  • Content-Typeheader

    application/json. Not needed for this request.

Query parameters

  • limitinteger

    1 to 50. Default 50.

  • pagestring

    The next_page value from the previous response.

  • sortstring

    name (default, A to Z) or created_at (newest first).

  • statusstring

    active (default), archived or all.

Errors

ErrorWhen
400invalid_limitinvalid_pageinvalid_sortinvalid_status
A query parameter has a value that is not allowed.
503query_timeout
Counting took too long. Use a smaller limit.
Request
curl "https://app.dmtracker.ai/api/v2/contacts/tags?limit=20" \
  -H "x-api-key: $DMTRACKER_API_KEY" \
  -H "Content-Type: application/json"
Response 200
{
  "status": "success",
  "data": [
    {
      "id": 287,
      "name": "hot lead",
      "color": "#22C55E",
      "status": "active",
      "contact_count": 42,
      "contact_count_precision": "exact",
      "created_at": "2025-12-15T09:50:03.336+00:00",
      "updated_at": "2026-01-22T15:53:35.430+00:00"
    }
  ],
  "has_more": false,
  "next_page": null
}
Link copied