---
title: "Get all environments"
method: GET
path: "/api/admin/environments"
tags: ["Environments"]
---

# Get all environments

`GET /api/admin/environments`

Retrieves all environments that exist in this Unleash instance.

## Response `200`

environmentsSchema

- EnvironmentsSchema — A versioned list of environments
  - `version` integer, required — Version of the environments schema
  - `environments` EnvironmentSchema[], required — List of environments
    - `name` string, required — The name of the environment
    - `type` string, required — The [type of environment](https://docs.getunleash.io/concepts/environments#environment-types).
    - `enabled` boolean, required — `true` if the environment is enabled for the project, otherwise `false`.
    - `protected` boolean, required — `true` if the environment is protected, otherwise `false`. A *protected* environment can not be deleted.
    - `sortOrder` integer, required — Priority of the environment in a list of environments, the lower the value, the higher up in the list the environment will appear. Needs to be an integer
    - `projectCount` integer, nullable — The number of projects with this environment
    - `apiTokenCount` integer, nullable — The number of API tokens for the project environment
    - `enabledToggleCount` integer, nullable — The number of enabled toggles for the project environment
    - `requiredApprovals` integer, nullable — Experimental field. The number of approvals required before a change request can be applied in this environment.

## Other responses

- `401` — Authorization information is missing or invalid. Provide a valid API token as the `authorization` header, e.g. `authorization:*.*.my-admin-token`.
- `403` — The provided user credentials are valid, but the user does not have the necessary permissions to perform this operation

---

[API](https://skmtc.net/unleash/apis/unleash-api-3.md) · [All operations](https://skmtc.net/unleash/apis/unleash-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unleash/unleash-api-3/revisions/b2c3116e633e/schema)