Skip to main content
GET
/
api
/
v1
/
tags
/
{id}
Get a tag by ID
curl --request GET \
  --url https://api.example.com/api/v1/tags/{id}
{
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "workspaceID": "<string>",
  "listingIds": [
    [
      "<string>"
    ]
  ],
  "description": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://ota-docs.calry.app/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
id
string
required

The unique identifier of the tag

Example:

"123e4567-e89b-12d3-a456-426614174000"

Query Parameters

​
includeListings
boolean

Whether to include listings attached to this tag

Example:

true

Response

Tag retrieved successfully

​
id
string
required

Unique identifier of the entity

​
createdAt
string<date-time>
required

Date and time when the entity was created

​
updatedAt
string<date-time>
required

Date and time when the entity was last updated

​
name
string
required

Name of the tag

​
workspaceID
string
required

ID of the workspace the tag belongs to

​
listingIds
string[][]
required

Listings associated with this tag

​
description
string

Optional description of the tag