curl --request GET \
--url 'https://api-prod.usefini.com/v2/tags/76f90f08-7857-4853-bc17-2f1487516a3d/public' \
--header 'Authorization: Bearer fini_your_api_key'
import requests
tag_id = "76f90f08-7857-4853-bc17-2f1487516a3d"
response = requests.get(
f"https://api-prod.usefini.com/v2/tags/{tag_id}/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
tag = response.json()
const tagId = "76f90f08-7857-4853-bc17-2f1487516a3d";
const response = await fetch(
`https://api-prod.usefini.com/v2/tags/${tagId}/public`,
{
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const tag = await response.json();
{
"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."
}
null
Tags
Get tag
Fetch one tag by ID.
GET
/
v2
/
tags
/
{id}
/
public
curl --request GET \
--url 'https://api-prod.usefini.com/v2/tags/76f90f08-7857-4853-bc17-2f1487516a3d/public' \
--header 'Authorization: Bearer fini_your_api_key'
import requests
tag_id = "76f90f08-7857-4853-bc17-2f1487516a3d"
response = requests.get(
f"https://api-prod.usefini.com/v2/tags/{tag_id}/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
tag = response.json()
const tagId = "76f90f08-7857-4853-bc17-2f1487516a3d";
const response = await fetch(
`https://api-prod.usefini.com/v2/tags/${tagId}/public`,
{
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const tag = await response.json();
{
"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."
}
null
Fetches one
Tag by ID.
Headers
string
required
Bearer token containing your Fini workspace API key. Format:
Bearer fini_... The key needs read scope.Path parameters
string
required
Tag ID to fetch.
curl --request GET \
--url 'https://api-prod.usefini.com/v2/tags/76f90f08-7857-4853-bc17-2f1487516a3d/public' \
--header 'Authorization: Bearer fini_your_api_key'
import requests
tag_id = "76f90f08-7857-4853-bc17-2f1487516a3d"
response = requests.get(
f"https://api-prod.usefini.com/v2/tags/{tag_id}/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
tag = response.json()
const tagId = "76f90f08-7857-4853-bc17-2f1487516a3d";
const response = await fetch(
`https://api-prod.usefini.com/v2/tags/${tagId}/public`,
{
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const tag = await response.json();
Response
Returns oneTag.
{
"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."
}
null
Current controller behavior: unknown tag IDs currently return
200 OK with null on this public route rather than a dedicated 404 Not Found.Errors
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 tag from storage.
Was this page helpful?

