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

# List Segments

> List all segments configured in your workspace.

Retrieve a list of manual and dynamic segments via the Mailofly API.

### Response

**data** `array`

**id** `string`

The segment ID.

**name** `string`

Segment name.

**type** `string`

Segment type (`manual` or `dynamic`).

**contactsCount** `number`

Active contact count.

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

```json 200 OK theme={null}
{
  "data": [
    {
      "id": "seg_123",
      "name": "High-Value Customers",
      "type": "dynamic",
      "contactsCount": 142
    },
    {
      "id": "seg_456",
      "name": "Newsletter Subscribers",
      "type": "manual",
      "contactsCount": 850
    }
  ]
}
```


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