List curation tags

GET

/api/v3/curations/tags

const url = 'https://api.tryletterhead.com/api/v3/curations/tags?api=true';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.tryletterhead.com/api/v3/curations/tags?api=true' \
  --header 'Authorization: Bearer <token>'

Returns a paginated list of tags applied to the company’s curations, across every channel.

Authorizations

bearerAuth

Parameters

Query Parameters

api

required

boolean

Required. Set to true to authenticate with your company API key rather than a signed-in session.

page

integer

perPage

integer

keyword

string

Filter tags by name.

from

string

(optional) Only tags first used on or after this date.

string

(optional) Only tags first used on or before this date.

Responses

200

200 OK

application/json

object

items

Array<object>

object

integer

name

string

uniqueId

string

taxonomyId

integer

parentTermId

integer

created_at

string

updated_at

string

message

string

total

integer

Example

{
  "items": [
    {
      "id": 41,
      "name": "coffee",
      "uniqueId": "tag_a1b2c3",
      "taxonomyId": 2,
      "parentTermId": 0,
      "created_at": "2026-01-14T10:02:00+00:00",
      "updated_at": "2026-08-11T08:00:00+00:00"
    }
  ],
  "message": "Company-wide tags retrieved successfully",
  "total": 1
}

Still can’t find what you need? Contact support.