---
title: "Get segment statistics"
method: GET
path: "/segments/{segmentID}/statistics"
tags: ["Segments"]
---

# Get segment statistics

`GET /segments/{segmentID}/statistics`

Returns statistics for a segment, including the total number of matching contacts.

**Scopes:**
`segments.read`

## Path parameters

- `segmentID` string, required

## Headers

- `Omnisend-Version` string, required

## Response `200`

Segment statistics

- GetSegmentStatisticsResponse — Segment statistics resource.
  - `contactsCount` integer — Segment contacts count (read-only)

## Other responses

- `400` — Request contains invalid or missing fields
- `401` — Authentication is missing or invalid
- `403` — Insufficient permissions for this operation
- `404` — Segment not found
- `410` — API version has been retired
- `429` — Rate limit exceeded
- `500` — Unexpected error occurred

---

[API](https://skmtc.dev/omnisend/apis/events-api.md) · [All operations](https://skmtc.dev/omnisend/apis/events-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisend/events-api/revisions/50214fbc283f/schema)