---
title: "GET /api/v1/projects/{project_pk}/segments/"
method: GET
path: "/api/v1/projects/{project_pk}/segments/"
tags: ["mcp"]
---

# GET /api/v1/projects/{project_pk}/segments/

`GET /api/v1/projects/{project_pk}/segments/`

Retrieves all user segments defined for audience targeting within the project.

## Path parameters

- `project_pk` integer, required

## Query parameters

- `identity` string
- `include_feature_specific` boolean
- `page` integer
- `page_size` integer
- `q` string

## Response `200`

- PaginatedSegmentList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Segment[], required
    - `id` integer
    - `uuid` string, uuid
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `name` string, required
    - `description` string, nullable
    - `project` integer
    - `feature` integer, nullable
    - `version_of` integer, nullable
    - `rules` SegmentRule[], required
      - `id` integer
      - `type` 'ALL' | 'ANY' | 'NONE', required — * `ALL` - all * `ANY` - any * `NONE` - none
      - `rules` NestedSegmentRule[]
        - `id` integer
        - `type` 'ALL' | 'ANY' | 'NONE', required — * `ALL` - all * `ANY` - any * `NONE` - none
        - `conditions` Condition[]
          - `id` integer
          - `operator` 'EQUAL' | 'GREATER_THAN' | 'LESS_THAN' | 'CONTAINS' | 'GREATER_THAN_INCLUSIVE' | 'LESS_THAN_INCLUSIVE' | 'NOT_CONTAINS' | 'NOT_EQUAL' | 'REGEX' | 'PERCENTAGE_SPLIT' | 'MODULO' | 'IS_SET' | 'IS_NOT_SET' | 'IN', required — * `EQUAL` - Exactly Matches * `GREATER_THAN` - Greater than * `LESS_THAN` - Less than * `CONTAINS` - Contains * `GREATER_THAN_INCLUSIVE` - Greater than or equal to * `LESS_THAN_INCLUSIVE` - Less than or equal to * `NOT_CONTAINS` - Does not contain * `NOT_EQUAL` - Does not match * `REGEX` - Matches regex * `PERCENTAGE_SPLIT` - Percentage split * `MODULO` - Modulo Operation * `IS_SET` - Is set * `IS_NOT_SET` - Is not set * `IN` - In
          - `property` string, nullable
          - `value` string, nullable
          - `description` string, nullable
          - `delete` boolean
        - `delete` boolean
      - `conditions` Condition[]
        - `id` integer
        - `operator` 'EQUAL' | 'GREATER_THAN' | 'LESS_THAN' | 'CONTAINS' | 'GREATER_THAN_INCLUSIVE' | 'LESS_THAN_INCLUSIVE' | 'NOT_CONTAINS' | 'NOT_EQUAL' | 'REGEX' | 'PERCENTAGE_SPLIT' | 'MODULO' | 'IS_SET' | 'IS_NOT_SET' | 'IN', required — * `EQUAL` - Exactly Matches * `GREATER_THAN` - Greater than * `LESS_THAN` - Less than * `CONTAINS` - Contains * `GREATER_THAN_INCLUSIVE` - Greater than or equal to * `LESS_THAN_INCLUSIVE` - Less than or equal to * `NOT_CONTAINS` - Does not contain * `NOT_EQUAL` - Does not match * `REGEX` - Matches regex * `PERCENTAGE_SPLIT` - Percentage split * `MODULO` - Modulo Operation * `IS_SET` - Is set * `IS_NOT_SET` - Is not set * `IN` - In
        - `property` string, nullable
        - `value` string, nullable
        - `description` string, nullable
        - `delete` boolean
      - `delete` boolean
    - `metadata` Metadata[]
      - `id` integer
      - `model_field` integer, required
      - `field_value` string, required
    - `membership_counts` SegmentMembershipCount[]
      - `environment` integer
      - `count` integer
      - `last_synced_at` string, date-time
    - `managed_by` union
      - 'cohort' — * `` - Unmanaged * `cohort` - Cohort
      - ''
    - `cohort` SegmentCohort
      - `id` integer
      - `environment` integer, required
      - `environment_api_key` string
      - `environment_name` string
      - `source_type` 'csv' | 'amplitude' | 'mixpanel' — * `csv` - CSV * `amplitude` - Amplitude * `mixpanel` - Mixpanel
      - `version` integer
      - `deletion_requested_at` string, date-time, nullable
    - `has_overrides` boolean — Whether any feature override points at this segment, counting overrides that are live now or scheduled to go live.

---

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