---
title: "List Environment(Endpoint) groups"
method: GET
path: "/endpoint_groups"
tags: ["endpoint_groups"]
---

# List Environment(Endpoint) groups

`GET /endpoint_groups`

List all environment(endpoint) groups based on the current user authorizations. Will
return all environment(endpoint) groups if using an administrator account otherwise it will
only return authorized environment(endpoint) groups.
**Access policy**: restricted

## Query parameters

- `size` boolean

## Response `200`

Environment(Endpoint) group

- EndpointgroupsEndpointGroupResponse[]
  - `Description` string, required — Description associated to the environment(endpoint) group
  - `Id` integer, required — Environment(Endpoint) group Identifier
  - `Name` string, required — Environment(Endpoint) group name
  - `TagIds` integer[] — List of tags associated to this environment(endpoint) group
  - `TeamAccessPolicies` PortainerTeamAccessPolicies
  - `Total` integer
  - `TypeInfo` EndpointgroupsEndpointGroupTypeInfo
    - `Docker` integer, required
    - `Kubernetes` integer, required
    - `Mixed` boolean, required
    - `Podman` integer, required
  - `UserAccessPolicies` PortainerUserAccessPolicies

## Other responses

- `500` — Server error

---

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