Tags

Get a tag

Retrieve a single tag by its unique ID, including its name and color.

GET /v1/tags/{tagId}

Parameters

Path parameters

tagId
string (uuid) required

Query parameters

include
object
select
object

Responses

200 — Successful response

Content-Type: application/json

error
boolean required
data
object required
data.tag
object required
data.tag.id
string (uuid) required
data.tag.user_id
string
data.tag.name
string
data.tag._count
object
data.tag._count.tags_contacts
integer

Example

{
  "error": false,
  "data": {
    "tag": {
      "id": "00000000-0000-0000-0000-000000000000"
    }
  }
}

400

No response body.

401

No response body.

403

No response body.

404

No response body.

429

No response body.

500

No response body.

Code samples

curl https://api.prod.getdex.com/v1/tags/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_API_KEY'
Copyright © 2026