---
title: "Get a segment"
method: GET
path: "/api/admin/segments/{id}"
tags: ["Segments"]
---

# Get a segment

`GET /api/admin/segments/{id}`

Retrieves a segment based on its ID.

## Path parameters

- `id` integer, required

## Response `200`

adminSegmentSchema

- AdminSegmentSchema — A description of a [segment](https://docs.getunleash.io/concepts/segments)
  - `id` integer, required — The ID of this segment
  - `name` string, required — The name of this segment
  - `description` string, nullable — The description for this segment
  - `constraints` ConstraintSchema[], required — The list of constraints that are used in this segment
    - `contextName` string, required — The name of the context field that this constraint should apply to.
    - `operator` 'NOT_IN' | 'IN' | 'STR_ENDS_WITH' | 'STR_STARTS_WITH' | 'STR_CONTAINS' | 'NUM_EQ' | 'NUM_GT' | 'NUM_GTE' | 'NUM_LT' | 'NUM_LTE' | 'DATE_AFTER' | 'DATE_BEFORE' | 'SEMVER_EQ' | 'SEMVER_GT' | 'SEMVER_LT' | 'SEMVER_GTE' | 'SEMVER_LTE' | 'REGEX', required — The operator to use when evaluating this constraint. For more information about the various operators, refer to [the strategy constraint operator documentation](https://docs.getunleash.io/concepts/activation-strategies#constraint-operators).
    - `caseInsensitive` boolean — Whether the operator should be case sensitive or not. Defaults to `false` (being case sensitive).
    - `inverted` boolean — Whether the result should be negated or not. If `true`, will turn a `true` result into a `false` result and vice versa.
    - `values` string[] — The context values that should be used for constraint evaluation. Use this property instead of `value` for properties that accept multiple values.
    - `value` string — The context value that should be used for constraint evaluation. Use this property instead of `values` for properties that only accept single values.
  - `usedInFeatures` integer, nullable — The number of feature flags that use this segment. The number also includes the any flags with pending change requests that would add this segment.
  - `usedInProjects` integer, nullable — The number of projects that use this segment. The number includes any projects with pending change requests that would add this segment.
  - `project` string, nullable — The project the segment belongs to. Only present if the segment is a project-specific segment.
  - `createdBy` string, nullable — The creator's email or username
  - `createdAt` string, date-time, required — When the segment was created

## Other responses

- `404` — The requested resource was not found.

---

[API](https://skmtc.net/unleash/apis/unleash-api-3.md) · [All operations](https://skmtc.net/unleash/apis/unleash-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unleash/unleash-api-3/revisions/b2c3116e633e/schema)