Skip to content

Tags API

List tags

GEThttps://email.growthdept.ai/api/tags

Tags in the account, filtered by name and sorted by name or id, with their tag group on request.

Sort by id, name, ascending or descending (put - in front).

Rate limits

Burst: 3/s

Steady: 60/m

Tier S. See rate limits for how requests are counted.

Scopes

tags:read

Operation id

get_tags The same operation as in Klaviyo's API. OpenAPI document

Query parameters

array of strings

Attributes of tag-group resources to return.

Sparse fieldsets guide

Pick values to add them to the request:

array of strings

Attributes of tag resources to return.

Sparse fieldsets guide

Pick values to add them to the request:

string

Filter expression.

Filtering guide

Fields and the operators each one takes:

  • name: contains, ends-with, equals, starts-with

array of strings

Related resources to side-load.

Includes guide

Pick values to add them to the request:

string

From links.next or links.prev of the previous page.

Pagination guide

integer1 to 50default 50

Default 50, at most 50.

Pagination guide

string

Default id.

Sorting guide

Headers

stringrequireddefault 2026-10-15

API revision, YYYY-MM-DD. This server implements 2026-10-15.

Revisions guide

Responses

200Success

Response body

object

  • dataarray of objectsrequired

    data: 5 fields
    • typestringrequired

      tag
    • idstringrequired

    • attributesobjectrequired

      attributes: 1 field
      • namestringrequired

    • relationshipsobject

      relationships: 5 fields
      • tag-groupobject

        tag-group: 2 fields
        • dataobject

          data: 2 fields
          • typestringrequired

            tag-group
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • listsobject

        lists: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            list
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • segmentsobject

        segments: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            segment
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • campaignsobject

        campaigns: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            campaign
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

      • flowsobject

        flows: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            flow
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

  • linksobject

    links: 3 fields
    • selfstring (uri)required

    • prevstring (uri)

    • nextstring (uri)

  • metaobject

  • includedarray of objects

    included: 5 fields
    • typestringrequired

      tag-group
    • idstringrequired

    • attributesobjectrequired

      attributes: 3 fields
      • namestringrequired

      • exclusivebooleanrequired

      • defaultbooleanrequired

    • relationshipsobject

      relationships: 1 field
      • tagsobject

        tags: 2 fields
        • dataarray of objects

          data: 2 fields
          • typestringrequired

            tag
          • idstringrequired

        • linksobject

          links: 2 fields
          • selfstring (uri)required

          • relatedstring (uri)required

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

4XXClient error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject

See status codes for each code.

5XXServer error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject