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

# Get segment

`GET /segments/{segmentID}`

Returns a segment by its unique identifier.

**Scopes:**
`segments.read`

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

## Path parameters

- `segmentID` string, required

## Headers

- `Omnisend-Version` string, required

## Response `200`

Segment resource

- GetSegmentResponse — Segment resource representation.
  - `archivedAt` string, nullable — Segment archival timestamp, null if not archived (read-only)
  - `conditionGroups` SegmentConditionGroup[] — Condition groups defining the segment rules
    - `conditions` SegmentCondition[] — List of conditions in this group
      - `entity` string — Entity type this condition applies to
      - `filters` unknown[], required — List of filter criteria. Must contain at least one item.
        - unknown
      - `junction` string — Logical operator combining the filters within this condition
  - `createdAt` string — Segment creation timestamp (read-only)
  - `isStarred` boolean — Whether the segment is marked as a favourite
  - `name` string — Segment name
  - `segmentID` string — Segment unique identifier (read-only)
  - `status` 'ready' | 'building' | 'archived' — Segment processing status (read-only)
  - `updatedAt` string — Segment last update timestamp (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)