---
title: "GET /api/v1/namespaces/{namespaceKey}/flags/{flagKey}/rollouts"
method: GET
path: "/api/v1/namespaces/{namespaceKey}/flags/{flagKey}/rollouts"
tags: ["Flipt", "RolloutsService"]
---

# GET /api/v1/namespaces/{namespaceKey}/flags/{flagKey}/rollouts

`GET /api/v1/namespaces/{namespaceKey}/flags/{flagKey}/rollouts`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/api/v1/namespaces/{namespaceKey}/flags/{flagKey}/rollouts`
- Auth: HTTP bearer

## Path parameters

- `namespaceKey` string, required
- `flagKey` string, required

## Query parameters

- `limit` integer
- `pageToken` string
- `reference` string

## Response `200`

OK

- RolloutList
  - `rules` Rollout[]
    - `id` string
    - `namespaceKey` string
    - `flagKey` string
    - `type` 'UNKNOWN_ROLLOUT_TYPE' | 'SEGMENT_ROLLOUT_TYPE' | 'THRESHOLD_ROLLOUT_TYPE', enum
    - `rank` integer
    - `description` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `segment` RolloutSegment
      - `segmentKey` string
      - `value` boolean
      - `segmentKeys` string[]
      - `segmentOperator` 'OR_SEGMENT_OPERATOR' | 'AND_SEGMENT_OPERATOR', enum
    - `threshold` RolloutThreshold
      - `percentage` number, float
      - `value` boolean
  - `nextPageToken` string
  - `totalCount` integer

## Changes

- **2024-08-08** `594afc3dbe2e`: 2 breaking, 5 warning
  - the `rules/items/segment/segmentOperator` response's property type changed from `integer` to `string` for status `200`
  - the `rules/items/type` response's property type changed from `integer` to `string` for status `200`
  - added the new `AND_SEGMENT_OPERATOR` enum value to the `rules/items/segment/segmentOperator` response property for the response status `200`
  - added the new `OR_SEGMENT_OPERATOR` enum value to the `rules/items/segment/segmentOperator` response property for the response status `200`
  - …3 more
- **2024-08-07** `291b2f802c58`: 2 breaking, 5 info
  - the `rules/items/segment/segmentOperator` response's property type changed from `string` to `integer` for status `200`
  - the `rules/items/type` response's property type changed from `string` to `integer` for status `200`
  - removed the `AND_SEGMENT_OPERATOR` enum value from the `rules/items/segment/segmentOperator` response property for the response status `200`
  - removed the `OR_SEGMENT_OPERATOR` enum value from the `rules/items/segment/segmentOperator` response property for the response status `200`
  - …3 more

[Operation history](https://skmtc.dev/flipt-io/apis/flipt-api/changes/api/v1/namespaces/:namespaceKey/flags/:flagKey/rollouts/get.md)

---

[API](https://skmtc.dev/flipt-io/apis/flipt-api.md) - [All operations](https://skmtc.dev/flipt-io/apis/flipt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flipt-io/apis/flipt-api/revisions/6fe4caf26f13?raw)