Segments

Get segment statistics

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

Scopes: segments.read

Rate Limiting: This endpoint is rate limited to 100 requests per minute.

get/segments/{segmentID}/statistics

Request

  • Base URL
    https://api.omnisend.com/api
  • URL
    https://api.omnisend.com/api/segments/{segmentID}/statistics
  • Auth
    • OAuth 2
      Client credentials
      Token URL: https://app.omnisend.com/oauth2/token scopes: segments.read
    • or API key in header Authorization

Path parameters

segmentIDstring required

Segment ID (24 character hexadecimal)

Headers

Omnisend-Versionstring required

API version that specifies the response format and behaviour (e.g., 2026-preview)

Response

Segment statistics

contactsCountinteger

Segment contacts count (read-only)

Example response

{
  "contactsCount": 1234
}

Changes

No recorded changes to this operation across all 1 revision of this API.