---
title: "List live components in one environment or across all"
canonical: "https://admiral.io/docs/api/environment-components/EnvironmentAPI_ListEnvironmentComponents"
---

# List live components in one environment or across all

`GET https://api.admiral.io/v1/environment-components`

Scope: `env:read`

### Query parameters

- `environment_id` (string): The environment to list. Omitted lists across every environment. Pattern `^env-[0-9a-z]+$`.
- `filter` (string): Filter expression to narrow results. Uses the Admiral filter DSL. Filterable fields: - `name`: filter by component name. - `kind`: filter by component kind. - `component_id`: the registry component (`cmp-`) it runs. - `version_id`: the registry version (`ver-`) it runs. Example: `field['component_id'] = 'cmp-7q2k9m4x8p1c' AND field['version_id'] = 'ver-3k9x2m7qpl0a'` Length at most 1024.
- `page_size` (integer (int32)): Maximum number of components to return per page. Defaults to 50 when omitted or 0; must not exceed 100. Value 0 to 100.
- `page_token` (string): Opaque pagination token from a previous response.

### Response 200

Success

- `components` (array of EnvironmentComponent): Live components, sorted by environment and then name.
  - `name` (string): Component name, unique within the environment.
  - `environment_id` (string): The environment it is live in. Pattern `^env-[0-9a-z]+$`. Read-only.
  - `kind` (ComponentKind): What its version is: Terraform, Helm or manifests. One of `COMPONENT_KIND_UNSPECIFIED`, `COMPONENT_KIND_TERRAFORM`, `COMPONENT_KIND_HELM`, `COMPONENT_KIND_MANIFESTS`.
  - `version` (VersionRef): The registry version it runs.
    - `component_id` (string): The registry component. Pattern `^cmp-[0-9a-z]+$`.
    - `version_id` (string): The registry version. Pattern `^ver-[0-9a-z]+$`.
    - `digest` (string): `sha256:<hex>` of the bundle.
    - `reference` (string): The tag or `sha256:` digest as given, such as `5.5.0` or `latest`.
  - `last_apply` (LastApply): The apply that last changed this component.
    - `change_set_id` (string): The change set that was applied. Pattern `^cs-[0-9a-z]+$`.
    - `revision_id` (string): The change set revision that was applied. Pattern `^rev-[0-9a-z]+$`.
    - `applied_at` (Timestamp): When the apply finished.
- `next_page_token` (string): Pagination token for the next page. Empty when there are no more results.
- `unreadable_environments` (integer (int32)): Across environments only: how many more environments match that the caller cannot read.