> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# query_segment_membership

> Paginated members (contacts) of a segment.

Lists the profiles that belong to a saved segment. For ad-hoc filtering by free-form conditions, use [`list_contacts`](/mcp/tools/list-contacts) with `custom_field_filters` instead.

## Parameters

| Parameter    | Type    | Required | Description                         |
| ------------ | ------- | -------- | ----------------------------------- |
| `segment_id` | integer | Yes      |                                     |
| `per_page`   | integer | No       | 1–200, default 100.                 |
| `cursor`     | string  | No       | Opaque pagination cursor.           |
| `format`     | string  | No       | `csv` (default), `json`, or `yaml`. |

## Output

```csv theme={null}
profile_id,email,name,added_at
8231,taylor@example.com,Taylor Swift,2026-05-10T...
8240,sam@example.com,Sam Smith,2026-05-11T...
```