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

# Get Flags

> Retrieve feature flag values for a tenant

## Request

```
GET /api/v1/flags
```

### Headers

| Header          | Required | Description                                                                                                                                                          |
| --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `X-Bundle-ID`   | Yes      | App bundle identifier                                                                                                                                                |
| `X-Team-ID`     | Yes      | Apple Developer Team ID                                                                                                                                              |
| `Authorization` | Yes      | `Bearer <attestation JWT>` — or an API key for server-side/simulator callers. Identity headers alone return 401. See [Authentication](/api-reference/authentication) |

### Rate limit headers

Responses include `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset`. 429 responses include `Retry-After`.

### Query parameters

| Parameter     | Type     | Default      | Description                               |
| ------------- | -------- | ------------ | ----------------------------------------- |
| `environment` | `string` | `production` | `production`, `staging`, or `development` |

## Response

```json theme={null}
{
  "flags": {
    "dark_mode": true,
    "upload_limit": 50,
    "theme": "modern",
    "beta_features": false
  }
}
```

Flag values are resolved for the requested environment. Each flag value is typed (boolean, integer, double, string, or JSON).

## Tier limits

| Tier       | Max flags        |
| ---------- | ---------------- |
| Free       | 10 (on/off only) |
| Pro        | 50/app           |
| Business   | 200/app          |
| Enterprise | Unlimited        |