# Search contacts matching a saved segment

**POST** `/segments/{segmentId}/contacts:search`

Combines the saved segment definition and the supplied query using AND semantics.
totalSize is evaluated lazily and may be cached for up to five minutes; evaluatedAt
reports when that count was calculated.

Authentication: bearerAuth
Required scopes: `contact:list`, `segment:read`
Allowed roles: `owner`, `admin`, `agent`
Authorization: Search contacts matching a saved segment in the caller's contact scope.

## Request body

- `application/json`: `ContactSearchRequest` required.

## Responses

- `200`: Current segment members
- `default`: Error