---
title: "List system segments"
method: GET
path: "/segments/system"
tags: ["Segments"]
---

# List system segments

`GET /segments/system`

Returns all predefined system segments. System segments are read-only
and cannot be modified or deleted.

## Response `200`

List of system segments.

- V4SegmentList
  - `object` string, required
  - `url` string, required
  - `data` V4Segment[], required
    - `object` string, required
    - `id` string, required — Segment identifier.
    - `url` string, required — Canonical API path.
    - `name` string, required — Display name.
    - `is_system` boolean, required — Whether this is a predefined system segment (read-only).
    - `conditions` V4SegmentCondition[], required — Targeting rules. Every rule must match for a user to fall into the segment (logical AND). Omit on update to leave existing conditions untouched; pass an empty array to clear.
      - `metric` string, required — Metric identifier. Corresponds to a configured `SegmentMetric` (`ref_table_field`). Common values: `environment`, `client_uid`, `custom_uid`, `client_advertiser_id`, `renewable`, `target_platform`.
      - `comparator` string, required — Comparison operator applied between the metric and `value`. `contains` / `not_contains` map to SQL LIKE semantics on string metrics; numeric comparators (`gt`/`gte`/`lt`/`lte`) require a numeric metric.
      - `value` string, required — String-encoded value to compare against. Cast to the metric's underlying type (e.g. int, string) on the server.
      - `negate` boolean — If `true`, the rule matches when the comparison is false (logical NOT applied to the individual rule). Defaults to `false`.
    - `created_at` string, date-time, required — ISO 8601 creation timestamp.
    - `updated_at` string, date-time, required — ISO 8601 last update timestamp.
  - `has_more` boolean, required
  - `next_cursor` string, nullable

## Other responses

- `401` — Unauthorized
- `500` — Internal error
- `502` — Upstream service failure
- `504` — Upstream timeout

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)