---
title: "List Environments"
method: GET
path: "/v1/environments?beta=true"
---

# List Environments

`GET /v1/environments?beta=true`

List environments with pagination support.

## Query parameters

- `limit` integer — Maximum number of environments to return
- `page` string, nullable — Opaque cursor from previous response for pagination. Pass the `next_page` value from the previous response.
- `include_archived` boolean — Include archived environments in the response

## Headers

- `anthropic-beta` string — Optional header to specify the beta version(s) you want to use. To use multiple betas, use a comma separated list like `beta1,beta2` or specify the header multiple times for each beta.
- `anthropic-version` string — The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning).
- `x-api-key` string, nullable

## Response `200`

Successful Response

- BetaEnvironmentListResponse — Response when listing environments. This response model uses opaque cursor-based pagination. Use the `page` query parameter with the value from `next_page` to fetch the next page.
  - `data` BetaEnvironment[], required — List of environments.
    - `archived_at` string, nullable, required — RFC 3339 timestamp when environment was archived, or null if not archived
    - `config` union, required — Environment configuration (either Anthropic Cloud or self-hosted)
      - BetaCloudConfig — `cloud` environment configuration.
        - `networking` union, required — Network configuration policy.
          - BetaUnrestrictedNetwork — Unrestricted network access.
            - `type` 'unrestricted', required — Network policy type
          - BetaLimitedNetwork — Limited network access.
            - `allow_mcp_servers` boolean, required — Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array.
            - `allow_package_managers` boolean, required — Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the `allowed_hosts` array.
            - `allowed_hosts` string[], required — Specifies domains the container can reach.
            - `type` 'limited', required — Network policy type
        - `packages` BetaPackages, required — Packages (and their versions) available in this environment.
          - `apt` string[], required — Ubuntu/Debian packages to install
          - `cargo` string[], required — Rust packages to install
          - `gem` string[], required — Ruby packages to install
          - `go` string[], required — Go packages to install
          - `npm` string[], required — Node.js packages to install
          - `pip` string[], required — Python packages to install
          - `type` 'packages' — Package configuration type
        - `type` 'cloud', required — Environment type
      - BetaSelfHostedConfig — Configuration for self-hosted environments.
        - `type` 'self_hosted', required — Environment type
    - `created_at` string, required — RFC 3339 timestamp when environment was created
    - `description` string, nullable, required — User-provided description for the environment; null when unset
    - `id` string, required — Environment identifier (e.g., 'env_...')
    - `metadata` object, required — User-provided metadata key-value pairs
    - `name` string, required — Human-readable name for the environment
    - `scope` 'organization' | 'account' — The visibility scope for this environment. 'organization' means visible to all accounts. 'account' means visible only to the owning account.
    - `type` 'environment', required — The type of object (always 'environment')
    - `updated_at` string, required — RFC 3339 timestamp when environment was last updated
  - `next_page` string, nullable, required — Token for fetching the next page of results. If `null`, there are no more results available. Pass this value to the `page` parameter in the next request.

## Other responses

- `4XX` — Error response. See our [errors documentation](https://platform.claude.com/docs/en/api/errors) for more details.

## Changes

- **2026-08-14** `e9d8152420c3` — 1 breaking
  - response property `data/items/description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2026-05-19** `40e330aba8bc` — 1 breaking, 2 info
  - added `#/components/schemas/BetaSelfHostedConfig` to the `data/items/config` response property `oneOf` list for the response status `200`
  - added the optional property `data/items/scope` to the response with the `200` status
  - added `self_hosted` discriminator mapping keys to the `data/items/config` response property for the response status `200`
- **2026-04-09** `d87d3ef6f636` — 1 warning
  - deleted the `cookie` request parameter `sessionKey`
- **2026-04-08** `69486316563e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/anthropics/apis/anthropic-api/changes/v1/environments?beta=true/get.md)

---

[API](https://skmtc.dev/anthropics/apis/anthropic-api.md) · [All operations](https://skmtc.dev/anthropics/apis/anthropic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/anthropics/anthropic-api/revisions/717ab2a5efd6/schema)