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

# List project environments

> List named environments on an accessible project.

List named environments on an accessible project.

Use a developer access key. This endpoint is part of the [CLI API](/api-reference/cli/overview), with its own response format and rate limit.

Required scopes: `env:read`.

The key owner must still be a workspace owner or administrator. Missing scope or admin access returns `403`; an unavailable or differently pinned project returns `404`. The response is a bare array of `{name}` objects in configured order.

## Parameters

<ParamField query="recordId" type="string" required>
  Nonempty project record ID. Must match the key’s project pin, if set.
</ParamField>

## Response

**200** — Returns the resource under `data`. Example IDs and values are illustrative.

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "name": "development"
    }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error --get \
    "https://api.getkato.io/cli/v1/env/environments" \
    -H "Authorization: Bearer $KATO_API_KEY" \
    --data-urlencode "recordId=$KATO_RECORD_ID"
  ```
</RequestExample>


## Related topics

- [CLI API](/api-reference/cli/overview.md)
- [All endpoints](/api-reference/endpoints.md)
- [List CLI projects](/api-reference/cli/projects.md)
- [Push environment variables](/api-reference/cli/push.md)
- [Authentication and API conventions](/api-reference/authentication.md)