> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mailofly.com/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.

### Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the segment.
</ParamField>

### Query Parameters

<ParamField query="limit" type="number" default="50">
  Number of contacts to return (max 100).
</ParamField>

<ParamField query="offset" type="number" default="0">
  Pagination offset.
</ParamField>

### Response

<ResponseField name="data" type="array">
  <ResponseField name="id" type="string">Contact ID.</ResponseField>
  <ResponseField name="email" type="string">Email address.</ResponseField>
  <ResponseField name="firstName" type="string">First name.</ResponseField>
  <ResponseField name="lastName" type="string">Last name.</ResponseField>
  <ResponseField name="unsubscribed" type="boolean">Unsubscribe status.</ResponseField>
</ResponseField>

<ResponseField name="pagination" type="object">
  <ResponseField name="total" type="number">Total count.</ResponseField>
  <ResponseField name="limit" type="number">Page limit.</ResponseField>
  <ResponseField name="offset" type="number">Page offset.</ResponseField>
</ResponseField>

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

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


## Related topics

- [List Contact Segments](/api/contacts/list-contact-segments.md)
- [List Contacts](/api/contacts/list-contacts.md)
- [List Segments](/api/segments/list-segments.md)
- [Add Contact to Segment](/api/contacts/add-contact-to-segment.md)
- [Delete Contact Segment](/api/contacts/delete-contact-segment.md)