The SDK endpoint lets your application resolve all feature flag values for a specific record with a single HTTP request. Instead of checking flags one by one, you fetch the complete flag state for a record — an organization, a user, or any entity you’ve registered — and branch on the results in your code. This endpoint is authenticated with a project-scoped API key, not a session token, making it safe to call from server-side application code.
Always call this endpoint from your server. API keys are project-scoped credentials — exposing them in client-side JavaScript or mobile app bundles gives anyone who finds the key access to your flag data. Store the key in an environment variable and proxy requests through your backend if needed.
Authentication
Generate an API key from Feature Flags → API Keys in the dashboard. Each key is scoped to a single project and must be passed as a bearer token on every request.
For more detail on creating and rotating keys, see API Keys.
Resolve all flags for a record
Pass the record’s full prefixed ID (e.g. org-0ujsswThIGTUYm2K8FjOOfXtY1K) as the path parameter. The API key must belong to the same project that owns the record — requests referencing records from other projects return a 404.
Example request:
Example response:
The flags object maps each group flag key to its resolved value:
enabled is the final decision — the server applies the rollout dice-roll for you, so if the flag is on but the record falls outside the rollout, enabled is false.rollout is the configured rollout percentage (0–100).source is "record" when the value comes from a per-record override, or "group-default" when it falls back to the group flag’s default.
Per-record overrides are applied automatically — if a record has an explicit value set for a flag, that value is returned; otherwise the group flag’s default is used.
Pass an optional ?env= query parameter (the environment’s key or name) to resolve flags for a specific environment; when omitted, the project’s default environment is used. If the value doesn’t match any environment, environment is null and flags is {}.
TypeScript integration
Check a single global flag
If you need to check one global flag rather than resolving a full record, use the check endpoint documented in Global Flags. Like every project-scoped endpoint, it accepts either your API key or a dashboard session:
It returns the resolved flag for the project’s default environment (or the ?env= you pass):
Here source is "cache" when the result was served from the 60-second Redis cache, or "global" when freshly computed. As with the SDK endpoint, enabled already reflects the rollout roll. 