Skip to main content

(Re)evaluate a saved segment (count + optional records)

POST 
/v1/segments/:segment_id/evaluate

Re-evaluate a saved segment and return its current member count.

The count is persisted on the segment, and for static segments the resolved membership is stored too — this is the same evaluation the product runs from the segment screen. Pass return_records=true for a capped sample of the matched records, sized with records_limit (25 by default, 100 maximum).

Run this after changing a filter, and before launching a campaign against the segment, so you know the real audience size. Requires the segments:read scope.

Request​

Responses​

Successful Response

Last updated on