Retrieve a Saved Segment's Summary

get

https://{yourAccountName}.api-us1.com/api/3/audiences/{segmentId}

Retrieves the summary (name, category, contact counts, dates) of one Saved Segment by its UUID.

Get the UUID from GET /api/3/audiences (list them or search by name with search). Contact counts are from the segment's last evaluation run, not live.

Only Saved Segments have a summary: segments that have a name. A segment without a name returns 404 here even though the segment exists. If you are not sure the segment is a Saved Segment, call GET /api/3/segmentsV2/{segmentId} first and check for a name.

To read the segment's definition use GET /api/3/segmentsV2/{segmentId}.

Responses

401

Unauthorized

403

Forbidden

404

Segment Not Found, or the segment is not a Saved Segment (it has no name)

200Retrieve a Saved Segment's Summary

400Bad Request