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

# List Segment Contacts

> Retrieve contacts matching the segment's rules or memberships.

Retrieve a paginated list of contacts belonging to the segment via the Mailofly API.

### Path Parameters

**id** `string` *required*

The unique identifier of the segment.

### Query Parameters

**limit** `number` (default: 50)

Number of contacts to return (max 100).

**offset** `number` (default: 0)

Pagination offset.

### Response

**data** `array`

**id** `string`

Contact ID.

**email** `string`

Email address.

**firstName** `string`

First name.

**lastName** `string`

Last name.

**unsubscribed** `boolean`

Unsubscribe status.

**pagination** `object`

**total** `number`

Total count.

**limit** `number`

Page limit.

**offset** `number`

Page offset.

```bash cURL theme={null}
curl -X GET "https://api.mailofly.com/segments/seg_123/contacts?limit=25" \
  -H "Authorization: Bearer mf_live_your_api_key"
```

```json 200 OK theme={null}
{
  "data": [
    {
      "id": "cnt_123",
      "email": "sarah@example.com",
      "firstName": "Sarah",
      "unsubscribed": false
    }
  ],
  "pagination": {
    "total": 142,
    "limit": 25,
    "offset": 0
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.