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

[
  {
    "id": "2bd5626c-2122-478c-9c34-94fcf2d2cccb",
    "createdAt": "2026-06-12T10:17:02.000Z",
    "tagGroupId": "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5",
    "tagName": "Cancel Order",
    "tagDescription": "Use when the customer wants to cancel an existing order."
  },
  {
    "id": "76f90f08-7857-4853-bc17-2f1487516a3d",
    "createdAt": "2026-06-12T10:16:00.000Z",
    "tagGroupId": "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5",
    "tagName": "Track Order",
    "tagDescription": "Use when the customer is asking where an existing order is."
  }
]
Lists the Tag objects in one tag group, ordered by createdAt descending.

​
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 whose tags you want to list.
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/tag-groups/4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5/tags/public' \
  --header 'Authorization: Bearer fini_your_api_key'

​
Response

The response is a top-level array of Tag objects. 
[
  {
    "id": "2bd5626c-2122-478c-9c34-94fcf2d2cccb",
    "createdAt": "2026-06-12T10:17:02.000Z",
    "tagGroupId": "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5",
    "tagName": "Cancel Order",
    "tagDescription": "Use when the customer wants to cancel an existing order."
  },
  {
    "id": "76f90f08-7857-4853-bc17-2f1487516a3d",
    "createdAt": "2026-06-12T10:16:00.000Z",
    "tagGroupId": "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5",
    "tagName": "Track Order",
    "tagDescription": "Use when the customer is asking where an existing order is."
  }
]
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 group or its tags. Unknown tag group IDs currently surface here as well.