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

# List Flags

> Returns a paginated list of flags with their latest config per environment.

## Path parameters

<ParamField path="projectId" type="string" required />

## Query parameters

<ParamField query="limit" type="number">
  Page size. 1–100, default 50.
</ParamField>

<ParamField query="cursor" type="number">
  Timestamp cursor from a previous response's `nextCursor`.
</ParamField>

## Response

<ResponseField name="items" type="FlagWithVersions[]" required>
  Each flag includes a `versions` map keyed by `environmentId` containing the latest `FlagVersion`
  for that environment.
</ResponseField>

<ResponseField name="nextCursor" type="number | null" required />

<ResponseField name="hasMore" type="boolean" required />

Each flag item:

| Field        | Type                                 | Description                              |
| ------------ | ------------------------------------ | ---------------------------------------- |
| `id`         | string                               |                                          |
| `key`        | string                               | Developer-facing identifier. Immutable.  |
| `name`       | string                               |                                          |
| `type`       | `"boolean" \| "string" \| "number"`  |                                          |
| `clientSafe` | boolean                              |                                          |
| `archivedAt` | `string \| null`                     | ISO 8601 or `null` if active             |
| `versions`   | `Record<environmentId, FlagVersion>` | See [Flag Config](/docs/concepts/flag-config) |

<RequestExample>
  ```bash theme={null}
  curl https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../flags \
    -H "Authorization: Bearer <server_key>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "flag_01hx...",
        "orgId": "org_01hx...",
        "projectId": "proj_01hx...",
        "key": "new-checkout",
        "name": "New Checkout Flow",
        "type": "boolean",
        "clientSafe": false,
        "archivedAt": null,
        "createdAt": "2024-03-01T12:00:00.000Z",
        "versions": {
          "env_01hx...": {
            "id": "fv_01hx...",
            "version": 2,
            "config": {
              "version": 2,
              "enabled": true,
              "defaultValue": false,
              "rules": []
            },
            "createdAt": "2024-04-01T09:00:00.000Z"
          }
        }
      }
    ],
    "nextCursor": null,
    "hasMore": false
  }
  ```
</ResponseExample>