---
title: "Get predefined variations"
method: GET
path: "/v1/settings/{settingId}/predefined-variations"
tags: ["Feature Flags & Settings"]
---

# Get predefined variations

`GET /v1/settings/{settingId}/predefined-variations`

This endpoint returns the predefined variations along with their usages in the Environments for a Feature Flag or Setting identified by the `settingId` parameter.

## Path parameters

- `settingId` integer, required

## Response `200`

When the update was successful.

- PredefinedVariationsWithUsagesModel
  - `settingKey` string, required — Key of the Feature Flag or Setting.
  - `settingType` 'boolean' | 'string' | 'int' | 'double', required — The type of the Feature Flag or Setting.
  - `predefinedVariations` PredefinedVariationWithUsagesModel[], required — The Feature Flag or Setting's Variations.
    - `value` PredefinedVariationValueModel, required — Represents the value of a Predefined Variation.
      - `boolValue` boolean, nullable, required — The served value in case of a boolean Feature Flag.
      - `stringValue` string, nullable, required — The served value in case of a text Setting.
      - `intValue` integer, nullable, required — The served value in case of a whole number Setting.
      - `doubleValue` number, double, nullable, required — The served value in case of a decimal number Setting.
    - `name` string, nullable, required — The name of the Predefined Variation, shown on the Dashboard UI. If not set, the Value will be shown.
    - `hint` string, nullable, required — The name of the Predefined Variation, shown on the Dashboard UI. If not set, the Value will be shown.
    - `predefinedVariationId` string, uuid, required — The Predefined Variation's identifier.
    - `usages` PredefinedVariationUsageModel[], required — The Feature Flag or Setting Variation's usages in the given Environments.
      - `settingId` integer, required
      - `environmentId` string, uuid, required
    - `usagesInOtherEnvironments` integer, required — The Feature Flag or Setting Variation's usages in the Environments you don't have access to.
    - `changeRequestUsages` PredefinedVariationChangeRequestUsageModel[], required — The Feature Flag or Setting Variation's usages in the given Change Requests.
      - `changeRequestId` integer, required
      - `changeRequestTitle` string, required
      - `settingId` integer, required
      - `environmentId` string, uuid, required
    - `changeRequestUsagesInOtherEnvironments` integer, required — The Feature Flag or Setting Variation's usages in the Change Requests you don't have access to.
  - `environments` PredefinedVariationEnvironmentModel[], required — The Environment descriptors for the Variations' usages.
    - `environmentId` string, uuid, required — The identifier of the Environment.
    - `name` string, required — The name of the Environment.
    - `accessType` 'full' | 'readOnly' | 'none', required — Represent the environment specific Feature Management permission.
  - `maxPredefinedVariations` integer, required — The maximum number of predefined variations allowed for the Feature Flag or Setting.

## Other responses

- `400` — Bad request.
- `404` — Not found.
- `429` — Too many requests. In case of the request rate exceeds the rate limits.

---

[API](https://skmtc.net/configcat/apis/configcat-public-management-api.md) · [All operations](https://skmtc.net/configcat/apis/configcat-public-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/configcat/configcat-public-management-api/versions/6b4d53bc1455/schema)