{
  "opencollection": "1.0.0",
  "info": {
    "name": "Klaviyo Accounts Lists API",
    "version": "2026-04-15"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Lists",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Lists",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/lists",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "fields[flow]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[list]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[tag]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "filter",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`name`: `any`, `equals`<br>`id`: `any`, `equals`<br>`created`: `greater-than`<br>`updated`: `greater-than`"
              },
              {
                "name": "include",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "Default: 10. Min: 1. Max: 10."
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
              }
            ]
          },
          "docs": "Get all lists in an account.\n\nFilter to request a subset of all lists. Lists can be filtered by `id`, `name`, `created`, and `updated` fields.\n\nReturns a maximum of 10 results per page.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`lists:read`"
        },
        {
          "info": {
            "name": "Create List",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://a.klaviyo.com/api/lists",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a new list.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`<br>Daily: `150/d`\n\n**Scopes:**\n`lists:write`"
        },
        {
          "info": {
            "name": "Get List",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/lists/:id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Primary key that uniquely identifies this list. Generated by Klaviyo."
              },
              {
                "name": "additional-fields[list]",
                "value": "",
                "type": "query",
                "description": "Request additional fields not included by default in the response. Supported values: 'profile_count'"
              },
              {
                "name": "fields[flow]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[list]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[tag]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "include",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
              }
            ]
          },
          "docs": "Get a list with the given list ID.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`<br><br>Rate limits when using the `additional-fields[list]=profile_count` parameter in your API request:<br>Burst: `1/s`<br>Steady: `15/m`<br><br>To learn more about how the `additional-fields` parameter impacts rate limits, check out our [Rate limits, status codes, and errors](https://developers.klaviyo.com/en/v2026-04-15/docs/rate_limits_and_error_handling) guide.\n\n**Scopes:**\n`lists:read`"
        },
        {
          "info": {
            "name": "Update List",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://a.klaviyo.com/api/lists/:id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Primary key that uniquely identifies this list. Generated by Klaviyo."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update the name of a list with the given list ID.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`\n\n**Scopes:**\n`lists:write`"
        },
        {
          "info": {
            "name": "Delete List",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://a.klaviyo.com/api/lists/:id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Primary key that uniquely identifies this list. Generated by Klaviyo."
              }
            ]
          },
          "docs": "Delete a list with the given list ID.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`\n\n**Scopes:**\n`lists:write`"
        },
        {
          "info": {
            "name": "Get Tags for List",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/lists/:id/tags",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Primary key that uniquely identifies this list. Generated by Klaviyo."
              },
              {
                "name": "fields[tag]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              }
            ]
          },
          "docs": "Return all tags associated with the given list ID.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`\n\n**Scopes:**\n`lists:read`\n`tags:read`"
        },
        {
          "info": {
            "name": "Get Tag IDs for List",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/lists/:id/relationships/tags",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Primary key that uniquely identifies this list. Generated by Klaviyo."
              }
            ]
          },
          "docs": "Return all tags associated with the given list ID.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`\n\n**Scopes:**\n`lists:read`\n`tags:read`"
        },
        {
          "info": {
            "name": "Get Profiles for List",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/lists/:id/profiles",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Primary key that uniquely identifies this list. Generated by Klaviyo."
              },
              {
                "name": "additional-fields[profile]",
                "value": "",
                "type": "query",
                "description": "Request additional fields not included by default in the response. Supported values: 'subscriptions', 'predictive_analytics'"
              },
              {
                "name": "fields[profile]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "filter",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`email`: `any`, `equals`<br>`phone_number`: `any`, `equals`<br>`push_token`: `any`, `equals`<br>`_kx`: `equals`<br>`joined_group_at`: `greater-or-equal`, `greater-than`, `less-or-equal`, `less-than`"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "Default: 20. Min: 1. Max: 100."
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
              }
            ]
          },
          "docs": "Get all profiles within a list with the given list ID.\n\nFilter to request a subset of all profiles. Profiles can be filtered by `email`, `phone_number`, `push_token`, and `joined_group_at` fields. Profiles can be sorted by the following fields, in ascending and descending order: `joined_group_at`<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`<br><br>Rate limits when using the `additional-fields[profile]=predictive_analytics` parameter in your API request:<br>Burst: `10/s`<br>Steady: `"
        },
        {
          "info": {
            "name": "Get Profile IDs for List",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/lists/:id/relationships/profiles",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Primary key that uniquely identifies this list. Generated by Klaviyo."
              },
              {
                "name": "filter",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`email`: `any`, `equals`<br>`phone_number`: `any`, `equals`<br>`push_token`: `any`, `equals`<br>`_kx`: `equals`<br>`joined_group_at`: `greater-or-equal`, `greater-than`, `less-or-equal`, `less-than`"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "Default: 20. Min: 1. Max: 100."
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting"
              }
            ]
          },
          "docs": "Get profile membership [relationships](https://developers.klaviyo.com/en/reference/api_overview#relationships) for a list with the given list ID.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`<br><br>Rate limits when using the `additional-fields[profile]=predictive_analytics` parameter in your API request:<br>Burst: `10/s`<br>Steady: `150/m`<br><br>To learn more about how the `additional-fields` parameter impacts rate limits, check out our [Rate limits, status codes, and errors](https"
        },
        {
          "info": {
            "name": "Add Profiles to List",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://a.klaviyo.com/api/lists/:id/relationships/profiles",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Add a profile to a list with the given list ID.\n\nIt is recommended that you use the [Subscribe Profiles endpoint](https://developers.klaviyo.com/en/reference/subscribe_profiles) if you're trying to give a profile [consent](https://developers.klaviyo.com/en/docs/collect_email_and_sms_consent_via_api) to receive email marketing, SMS marketing, or both.\n\nThis endpoint accepts a maximum of 1000 profiles per call.<br><br>*Rate limits*:<br>Burst: `10/s`<br>Steady: `150/m`\n\n**Scopes:**\n`lists:write`\n`p"
        },
        {
          "info": {
            "name": "Remove Profiles from List",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://a.klaviyo.com/api/lists/:id/relationships/profiles",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Remove a profile from a list with the given list ID.\n\nThe provided profile will no longer receive marketing from this particular list once removed.\n\nRemoving a profile from a list will not impact the profile's [consent](https://developers.klaviyo.com/en/docs/collect_email_and_sms_consent_via_api) status or subscription status in general.\nTo update a profile's subscription status, please use the [Unsubscribe Profiles endpoint](https://developers.klaviyo.com/en/reference/unsubscribe_profiles).\n\nTh"
        },
        {
          "info": {
            "name": "Get Flows Triggered by List",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/lists/:id/flow-triggers",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Primary key that uniquely identifies this list. Generated by Klaviyo."
              },
              {
                "name": "fields[flow]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              }
            ]
          },
          "docs": "Get all flows where the given list ID is being used as the trigger.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`\n\n**Scopes:**\n`flows:read`\n`lists:read`"
        },
        {
          "info": {
            "name": "Get IDs for Flows Triggered by List",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/lists/:id/relationships/flow-triggers",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "Primary key that uniquely identifies this list. Generated by Klaviyo."
              }
            ]
          },
          "docs": "Get the IDs of all flows where the given list is being used as the trigger.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`\n\n**Scopes:**\n`flows:read`\n`lists:read`"
        }
      ]
    }
  ],
  "bundled": true
}