---
title: "List all environments."
method: GET
path: "/environments"
tags: ["Installation"]
---

# List all environments.

`GET /environments`

## Request

- Base URL: `/management/v2` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/management/v2/environments`
- Auth: one of:
  - HTTP basic
  - API key in cookie `Auth-Graviteeio-APIM`

List all environments accessible by the current user.

User must be authenticated.

## Query parameters

- `page` integer
- `perPage` integer

## Response `200`

Page of environments

- object
  - `data` Environment[]: List of Environments.
    - `id` string: Environment's uuid.
    - `name` string: Environment's name. Duplicate names can exists.
    - `description` string: Environment's description. A short description of your Environment.
  - `metadata` MetadataResponse: Generic object to handle additional information about an entity. Can also be used for pagination data.
  - `links` Links: List of links for pagination
    - `self` string: Link to current resource
    - `first` string: In a paginated response, link to the first page
    - `last` string: In a paginated response, link to the last page
    - `previous` string: In a paginated response, link to the previous page. Maybe null if current is the first page
    - `next` string: In a paginated response, link to the next page. Maybe null if current is the last page

## Other responses

- `default`: Generic error response

## Changes

- **2024-04-18** `88664aaa8dd8`: 1 breaking
  - the `details/items/invalidValue` response's property type changed from `object` to no type for status `default`

[Operation history](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-installation/changes/environments/get.md)

---

[API](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-installation.md) - [All operations](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-installation/llms.txt) - [OpenAPI document](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-installation/revisions/adff27ddef52?raw)