Skip to main content
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

​
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 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 one Tag. 
{
  "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

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 from storage.