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'
import requests
tag_group_id = "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5"
response = requests.get(
f"https://api-prod.usefini.com/v2/tag-groups/{tag_group_id}/tags/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
tags = response.json()
const tagGroupId = "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5";
const response = await fetch(
`https://api-prod.usefini.com/v2/tag-groups/${tagGroupId}/tags/public`,
{
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const tags = await response.json();
[
{
"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."
}
]
Tags
List tags in group
List the tags inside one tag group.
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'
import requests
tag_group_id = "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5"
response = requests.get(
f"https://api-prod.usefini.com/v2/tag-groups/{tag_group_id}/tags/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
tags = response.json()
const tagGroupId = "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5";
const response = await fetch(
`https://api-prod.usefini.com/v2/tag-groups/${tagGroupId}/tags/public`,
{
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const tags = await response.json();
[
{
"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
string
required
Bearer token containing your Fini workspace API key. Format:
Bearer fini_... The key needs read scope.Path parameters
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'
import requests
tag_group_id = "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5"
response = requests.get(
f"https://api-prod.usefini.com/v2/tag-groups/{tag_group_id}/tags/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
tags = response.json()
const tagGroupId = "4fbcebbd-693d-4fb8-84b2-c8fd0edee4c5";
const response = await fetch(
`https://api-prod.usefini.com/v2/tag-groups/${tagGroupId}/tags/public`,
{
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const tags = await response.json();
Response
The response is a top-level array ofTag 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."
}
]
Errors
400 Bad Request
400 Bad Request
The tag group does not exist or does not belong to the workspace tied to your API key.
401 Unauthorized
401 Unauthorized
The API key is missing, malformed, revoked, or invalid.
403 Forbidden
403 Forbidden
The API key does not include the
read scope required for this route.500 Internal Server Error
500 Internal Server Error
Fini failed while loading the group or its tags.
Was this page helpful?

