GET /api/segments/{id}
Get a segment with the given segment ID.
Rate limits:
Burst: 75/s
Steady: 700/m
Rate limits when using the additional-fields[segment]=profile_count parameter in your API request:
Burst: 1/s
Steady: 15/m
To learn more about how the additional-fields parameter impacts rate limits, check out our Rate limits, status codes, and errors guide.
Scopes:
segments:read
Servers
- https://a.klaviyo.com
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
String | Yes |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
revision |
String | Yes |
API endpoint revision (format: YYYY-MM-DD[.suffix]) Default value: "2025-07-15" |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
include[] |
Array | No |
For more information please visit https://developers.klaviyo.com/en/v2025-07-15/reference/api-overview#relationships |
additional-fields[segment][] |
Array | No |
Request additional fields not included by default in the response. Supported values: 'profile_count' |
fields[tag][] |
Array | No |
For more information please visit https://developers.klaviyo.com/en/v2025-07-15/reference/api-overview#sparse-fieldsets |
fields[flow][] |
Array | No |
For more information please visit https://developers.klaviyo.com/en/v2025-07-15/reference/api-overview#sparse-fieldsets |
fields[segment][] |
Array | No |
For more information please visit https://developers.klaviyo.com/en/v2025-07-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.