---
title: "Get or evaluate configuration"
method: GET
path: "/sdk/v2/configurations/"
tags: ["SDK Configurations (V2)"]
---

# Get or evaluate configuration

`GET /sdk/v2/configurations/`

Returns a configuration for the calling SDK's application and environment. When identity headers (distinct-id, unit-type) are present, evaluates active experiments, persists assignments and exposure proxies, applies changesets, and returns the merged configuration with experiment metadata. Without identity headers, returns the unevaluated base configuration. Supply the SDK's stored hash or If-None-Match header for 304 change detection.

## Query parameters

- `configuration` string
- `hash` string

## Headers

- `environment` 'production' | 'development'
- `project-id` integer
- `distinct-id` string
- `unit-type` 'user' | 'server'
- `evaluation-context` string

## Response `200`

Default Response

- object
  - `hash` string, required
  - `configurationId` number, required
  - `name` union, required
    - string
    - unknown
  - `configuration` Schema0, required — unresolved $ref
  - `privacy` array[], required
    - string[]
  - `updatedAt` string, date-time, required
  - `experiments` object[], required
    - `experimentId` number, required
    - `groupId` number, required
    - `assignmentVersion` number, required
    - `source` 'weightedHash' | 'roundRobin' | 'manual', required
    - `exposureProxyRecorded` boolean, required
  - `requiredProperties` string[], required

## Other responses

- `304` — Default Response
- `400` — Default Response
- `403` — Default Response
- `404` — Default Response
- `503` — Default Response

---

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