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

# Retrieve Segment

> Retrieve details of a specific segment.

Retrieve configuration, type, and current contact count for a segment via the Mailofly API.

### Path Parameters

**id** `string` *required*

The unique identifier of the segment.

### Response

**data** `object`

**id** `string`

The segment ID.

**name** `string`

The segment name.

**type** `string`

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

**contactsCount** `number`

Number of contacts.

**criteria** `object`

Filter conditions.

```bash cURL theme={null}
curl -X GET https://api.mailofly.com/segments/seg_123 \
  -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
  }
}
```


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