Query Segment Values
POST {{baseUrl}}/api/segment-values-reports/
> 🚧 This endpoint is in beta and subject to change.
>
> A beta revision header (2024-07-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our [versioning and deprecation policy](https://developers.klaviyo.com/en/docs/api_versioning_and_deprecation_policy) for more information.
Returns the requested segment analytics values data.
Rate limits:
Burst: 1/s
Steady: 2/m
Daily: 225/d
Scopes:
segments:read
Request Body
{"data"=>{"type"=>"segment-values-report", "attributes"=>{"statistics"=>["members_added", "members_removed"], "timeframe"=>{"key"=>"last_365_days"}, "filter"=>"<string>"}}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
revision | string | (Required) API endpoint revision (format: YYYY-MM-DD[.suffix]) | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"data":{"type":"segment-values-report","attributes":{"results":[{"groupings":{},"statistics":{}},{"groupings":{},"statistics":{}}]},"links":{"self":"\u003curi\u003e"}}}