> ## 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 Project Proposals

> Returns all proposals across all environments and flags in a project.

Useful for a project-wide change request review queue.

## Path parameters

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

## Query parameters

<ParamField query="status" type="&#x22;pending&#x22; | &#x22;approved&#x22; | &#x22;rejected&#x22;">
  Filter by status.
</ParamField>

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

<ParamField query="cursor" type="number">
  Timestamp cursor for the next page.
</ParamField>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "prop_01hx...",
        "flagId": "flag_01hx...",
        "environmentId": "env_01hx...",
        "status": "pending",
        "proposedConfig": { ... },
        "createdBy": "key_01hx...",
        "createdAt": "2024-04-10T14:00:00.000Z",
        "reviewedBy": null,
        "reviewedAt": null,
        "reviewNote": null
      }
    ],
    "nextCursor": null,
    "hasMore": false
  }
  ```
</ResponseExample>