Get or evaluate configuration
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.
Authorization
sdkApiKey SDK (public) key, prefixed gb_pk_ (older keys: sdk_). Send it as the authorization header value. Scoped to one project, so it is safe to ship in a game build.
In: header
Query Parameters
1 <= length1 <= lengthHeader Parameters
Environment alias. Defaults to development when omitted; studio is accepted as a synonym for it. Any alias outside the calling key's environment scope is rejected with 403.
1 <= lengthValue in
- "production"
- "development"
0 < value <= 90071992547409911 <= length <= 256Value in
- "user"
- "server"
1 <= lengthResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/sdk/v2/configurations/"{ "hash": "9f2c4e1ab7d0c3e58f6a2b1d4c7e9f0a3b5d8c1e2f4a6b8d0c2e4f6a8b0d2c4e", "configurationId": 12, "name": "Game Settings", "configuration": { "PlayerSpeed": 16, "NPCs": { "Spider": { "Health": 120 } } }, "privacy": [], "updatedAt": "2026-09-24T17:00:00.000Z", "experiments": [ { "experimentId": 7, "groupId": 21, "assignmentVersion": 1, "source": "weightedHash", "exposureProxyRecorded": true } ], "requiredProperties": []}