> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nonefivem.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Feature Flag

> Fetch a single feature flag by its ID

Fetches one flag by its UUID.

<Note>
  To read a flag's *value* by key on a game server, poll
  [`GET /flags/config`](/cloud/api-reference/flags/config) instead — it serves
  every flag at once from the edge cache rather than costing a request per flag.
</Note>

## Authorization

<ParamField header="Authorization" type="string" required>
  Bearer token for authentication. Format: `Bearer <your-api-key>`
</ParamField>

## Required Permission

`FLAGS_READ`

## Path Parameters

<ParamField path="flagId" type="string" required>
  The flag's UUID.
</ParamField>

## Response

Returns the flag — the same shape as a single entry in
[`GET /flags`](/cloud/api-reference/flags/list).

## Status Codes

| Status | Meaning                           |
| ------ | --------------------------------- |
| `200`  | The flag                          |
| `400`  | `flagId` is not a valid UUID      |
| `401`  | Invalid or missing API key        |
| `403`  | The key lacks `FLAGS_READ`        |
| `404`  | No such flag in this organization |

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.nonefivem.com/cloud/flags/550e8400-e29b-41d4-a716-446655440000" \
    -H "Authorization: Bearer your-api-key"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "new-hud",
    "name": "New HUD",
    "description": "Rolls out the redesigned heads-up display",
    "type": "boolean",
    "value": true,
    "runtime": "shared",
    "archived": false,
    "locked": false,
    "createdAt": "2026-09-01T10:00:00.000Z",
    "updatedAt": "2026-09-19T12:00:00.000Z"
  }
  ```
</ResponseExample>