Read Tag

The Read Tag endpoint lists the active tags in your organization, sorted alphabetically by label by default. Despite the singular name, it returns a paginated array, not a single tag. To fetch one tag by its ID, use GET /Tag/:id, which returns a single tag object under data.results (404 if not found).

When to use it

Use this endpoint to populate a tag picker or filter dropdown, or to search for an existing tag by name before deciding whether to create a new one with Create Tag.

Example request

curl "https://api.turbodocx.com/Tag?limit=25&offset=0&query=legal" \
  -H "Authorization: Bearer $TURBODOCX_API_KEY" \
  -H "x-rapiddocx-org-id: $TURBODOCX_ORG_ID" \
  -H "Accept: application/json"

limit defaults to 6, offset to 0. query filters by a case-insensitive match on label. Sort with column0 (label, createdOn, or updatedOn) and order0 (asc or desc).

Example response

{
  "data": {
    "results": [
      {
        "id": "7c1a0b52-9e88-4f0d-b3a2-1d4c6f8e2a90",
        "label": "legal",
        "isActive": true,
        "orgId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
        "createdBy": "f5e6d7c8-9a0b-4c1d-2e3f-4a5b6c7d8e9f",
        "createdOn": "2026-05-01T14:22:10.000Z",
        "updatedOn": "2026-05-01T14:22:10.000Z"
      }
    ],
    "totalRecords": 1
  }
}

Common errors

Status	When	Response body
401	Missing or invalid API key/token, or the organization cannot be resolved	Empty (status only)
400	A query parameter fails validation	{ "message", "type": "ValidationError", "data": { "errors": [...] } }

Related endpoints

• Create Tag to add a new tag

• Update Tag to rename an existing tag

• Delete Tags (by IDs) to remove tags in bulk

• GET /Tag/:id to fetch a single tag by ID

  GET

  /Tag