Skip to main content
GET
/
v2
/
tag-groups
/
{id}
/
public
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/tag-groups/4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5/public' \
  --header 'Authorization: Bearer fini_your_api_key'

{
  "id": "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5",
  "createdAt": "2026-06-12T10:14:22.000Z",
  "companyId": "38ba4db0-31db-4669-bb95-7b8313c4016b",
  "title": "Order Intent",
  "description": "Primary order-related intent used for routing and reporting.",
  "prompt": "Choose the single tag that best describes the customer's order request.",
  "multiselect": false,
  "updatedAt": "2026-06-12T10:14:22.000Z",
  "mandatory": false,
  "isOutputTagGroup": false
}
Fetches one TagGroup by ID.

​
Headers

​
Authorization
string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs read scope.

​
Path parameters

​
id
string
required
Tag group ID to fetch.
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/tag-groups/4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5/public' \
  --header 'Authorization: Bearer fini_your_api_key'

​
Response

Returns one TagGroup. 
{
  "id": "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5",
  "createdAt": "2026-06-12T10:14:22.000Z",
  "companyId": "38ba4db0-31db-4669-bb95-7b8313c4016b",
  "title": "Order Intent",
  "description": "Primary order-related intent used for routing and reporting.",
  "prompt": "Choose the single tag that best describes the customer's order request.",
  "multiselect": false,
  "updatedAt": "2026-06-12T10:14:22.000Z",
  "mandatory": false,
  "isOutputTagGroup": false
}
Current controller behavior: unknown tag group IDs currently surface as 500 Internal Server Error on this public route rather than a dedicated 404 Not Found.

​
Errors

The API key is missing, malformed, revoked, or invalid.
The API key does not include the read scope required for this route.
Fini failed while loading the tag group. Unknown IDs currently surface here as well.