Get a tag

GET

/public/v1/tags/{id}

Fetches a single tag by its ID. Returns 404 when no tag with that ID exists for the authenticated company — IDs from another company are never visible.

Any authenticated API key for the company may read tags; no additional settings permission is required.

Authorization

Bearer

headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Path Parameters

id*string

ID of the tag to fetch, as returned by the list and upsert endpoints.

Response Body

A single tag

*/*

response

A single tag envelope

data?

A tag

Example Request

curl -X GET 'https://app.distru.com/public/v1/tags/00000000-0000-0000-0000-00000000000a'

Example Request

curl -X GET 'https://app.distru.com/public/v1/tags/00000000-0000-0000-0000-00000000000a'

Example ResponseSchema

{
  "data": {
    "id": "00000000-0000-0000-0000-00000000000a",
    "inserted_datetime": "2026-08-24T16:01:07.045841Z",
    "name": "Top Shelf",
    "updated_datetime": "2026-08-24T16:01:07.045841Z"
  }
}

{  "data": {    "id": "00000000-0000-0000-0000-00000000000a",    "inserted_datetime": "2026-08-24T16:01:07.045841Z",    "name": "Top Shelf",    "updated_datetime": "2026-08-24T16:01:07.045841Z"  }}

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Response Body