> ## 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 Environments

> Returns a paginated list of environments for a project.

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

<ParamField query="slug" type="string">
  Optional exact slug filter. When provided, results are constrained to at most one environment.
</ParamField>

When `slug` is present:

* `cursor` is not allowed (`422 VALIDATION_ERROR`)
* `limit` is ignored and internally forced to 1

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

  curl "https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../environments?slug=production" \
   -H "Authorization: Bearer <server_key>"

  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "env_01hx...",
        "orgId": "org_01hx...",
        "projectId": "proj_01hx...",
        "name": "Production",
        "slug": "production",
        "color": "#ef4444",
        "protected": false,
        "createdAt": "2024-03-01T12:00:00.000Z"
      }
    ],
    "nextCursor": null,
    "hasMore": false
  }
  ```
</ResponseExample>