List a contact's tags

GET/api/v2/contacts/{username_or_id}/tags

Returns the tags on one contact, with who added each one and when.

Rate limit 300 requests per minute

Headers

x-api-keyheaderRequired
Your API key.
Content-Typeheader
application/json. Not needed for this request.

Path parameters

username_or_idstringRequired
Instagram username or contact id.

Query parameters

statusstring
active (default), archived or all.

Errors

Error	When
400`invalid_status`	`status` is not `active`, `archived` or `all`.
404`contact_not_found`	No contact with that username or id in your organization.

Request

curl "https://app.dmtracker.ai/api/v2/contacts/jane.fitness/tags?status=all" \
  -H "x-api-key: $DMTRACKER_API_KEY" \
  -H "Content-Type: application/json"

Response 200

{
  "status": "success",
  "contact": {
    "id": "7c1e9a52-3f4b-4d2a-9e61-0b8f2d5c4a17",
    "username": "jane.fitness",
    "full_name": "Jane Cooper"
  },
  "data": [
    {
      "id": 287,
      "name": "hot lead",
      "color": "#22C55E",
      "status": "active",
      "applied_at": "2026-10-21T15:20:11.746+00:00",
      "applied_by": "alex@yourcompany.com"
    }
  ],
  "total": 1
}