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

# List all environments.

`GET /environments`

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

---

[API](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-installation.md) · [All operations](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-installation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gravitee-io/gravitee-io-apim-management-api-installation/versions/adff27ddef52/schema)