---
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, required — User-provided description for the environment
    - `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.

---

[API](https://skmtc.net/anthropics/apis/anthropic-api.md) · [All operations](https://skmtc.net/anthropics/apis/anthropic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anthropics/anthropic-api/versions/93d8fd7d6493/schema)