GET /api/segments
Get all segments in an account.
Filter to request a subset of all segments. Segments can be filtered by name, created, and updated fields.
Returns a maximum of 10 results per page.
Rate limits:
Burst: 75/s
Steady: 750/m
Scopes:
segments:read
OpenAPI Spec
Servers
- https://a.klaviyo.com
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
revision |
String | Yes |
API endpoint revision (format: YYYY-MM-DD[.suffix]) Default value: "2026-04-15" |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
page[cursor] |
String | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination |
include[] |
Array | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships |
filter |
String | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering |
sort |
String | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting Valid values:
|
fields[tag][] |
Array | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets |
page[size] |
Integer | No |
Default: 10. Min: 1. Max: 10. Default value: 10 |
fields[flow][] |
Array | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets |
fields[segment][] |
Array | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.