---
title: "Get all segments"
method: GET
path: "/api/admin/segments"
tags: ["Segments"]
---

# Get all segments

`GET /api/admin/segments`

Retrieves all segments that exist in this Unleash instance.

## Response `200`

segmentsSchema

- SegmentsSchema — Data containing a list of [segments](https://docs.getunleash.io/concepts/segments)
  - `segments` AdminSegmentSchema[] — A list of 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

---

[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)