Get Tag Groups

//native

type Klaviyo = {

  apiKey: string;

};

/**

 * Get Tag Groups

 * List all tag groups in an account. Every account has one default tag group.

Tag groups can be filtered by `name`, `exclusive`, and `default`, and sorted by `name` or `id` in ascending or descending order.

Returns a maximum of 25 tag groups per request, which can be paginated with

[cursor-based pagination](https://developers.klaviyo.com/en/v2022-10-17/reference/api_overview#pagination).*Rate limits*:Burst: `3/s`Steady: `60/m`

 */

export async function main(

  auth: Klaviyo,

  fields_tag_group_: string | undefined,

  filter: string | undefined,

  page_cursor_: string | undefined,

  sort: "id" | "-id" | "name" | "-name" | undefined,

  revision: string,

) {

  const url = new URL(`https://a.klaviyo.com/api/tag-groups`);

  for (const [k, v] of [

    ["fields[tag-group]", fields_tag_group_],

    ["filter", filter],

    ["page[cursor]", page_cursor_],

    ["sort", sort],

  ]) {

    if (v !== undefined && v !== "" && k !== undefined) {

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      revision: revision,

      "Accept": "application/vnd.api+json",

      Authorization: "Klaviyo-API-Key " + auth.apiKey,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}