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

# Retrieve Metrics

> Retrieve performance and growth metrics for a segment (Beta).

Retrieve aggregated delivery, open, and click rates for emails sent to contacts within this segment via the Mailofly API.

> **Beta Feature**: Segment metrics are currently in active preview and subject to schema improvements.

### Path Parameters

**id** `string` *required*

The unique identifier of the segment.

### Response

**data** `object`

**totalContacts** `number`

Total members in segment.

**activeContacts** `number`

Number of actively engaged contacts.

**openRate** `number`

Average open percentage across recent campaigns.

**clickRate** `number`

Average click-through percentage.

**bounceRate** `number`

Bounce percentage.

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

```json 200 OK theme={null}
{
  "data": {
    "totalContacts": 142,
    "activeContacts": 118,
    "openRate": 48.6,
    "clickRate": 12.3,
    "bounceRate": 0.4
  }
}
```


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