Get Tags
GET {{baseUrl}}/api/tags/
List all tags in an account.
Tags can be filtered by name
, and sorted by name
or id
in ascending or descending order.
Returns a maximum of 50 tags per request, which can be paginated with cursor-based pagination.
Rate limits:
Burst: 3/s
Steady: 60/m
Scopes:
Tags Read
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
fields[tag] | string | For more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#sparse-fieldsets | |
filter | string | For more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>name : contains , ends-with , equals , starts-with | |
page[cursor] | string | For more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#pagination | |
sort | string | For more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#sorting |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
revision | string | (Required) API endpoint revision (format: YYYY-MM-DD[.suffix]) | |
Accept | string |
RESPONSES
status: OK
{"data":[{"type":"tag","id":"abcd1234-ef56-gh78-ij90-abcdef123456","attributes":{"name":"My Tag"},"links":{"self":"http://ysV.jfTg9uGG+.65KmbubqRAwNPJgoepiI2kevI"}},{"type":"tag","id":"abcd1234-ef56-gh78-ij90-abcdef123456","attributes":{"name":"My Tag"},"links":{"self":"https://Y.mpGEFXcWMo0Joa3J0RoPb8vnnDpMoV2,VyaVLDvz+vbUaDcqVmdmCaZ"}}],"links":{"self":"https://JarIYPdfeUw.zlduoH5wDTXY7nW","first":"http://VCeYoodXLlJiFLabNdUUZfR.xckduJr8+TBjBDU4rjXHnndy.BrZU","last":"https://UBWXutyaqKswDQIHuTqlblEQxv.raZHoHi9Q79SP-JZgHgWVv7fTBV3Y5BYGpTLRKTv7smNaQgR6U7JZYWTK4sAPtR","prev":"https://gOCAdYm.gbuGTl5lKrW0PTRueNjZNgM48pk-C2X4+awxsY8,+9Ms6PzlI+-Qz4xG+vCfLjSpezAF+","next":"http://efCKckRyUBCSfUXrGqLXWMGhGCyz.cuC1XomXCOFJVQ49P++ZPYlqwDYoFaej"}}