---
title: "List Environments"
method: GET
path: "/v1/accounts/{account_id}/environments"
tags: ["Environments"]
---

# List Environments

`GET /v1/accounts/{account_id}/environments`

## Request

- Base URL: `https://api.rivery.io`
- URL: `https://api.rivery.io/v1/accounts/{account_id}/environments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rivery/apis/boomi-data-integration-api/docs/v1/accounts/:account_id/environments/get.ts> (a function with typed inputs; its response is checked against the schema)

**Authorization scope:** `environment:list` 
 
 **Get list of environments entities for an account**

## Path parameters

- `account_id` string, required

## Query parameters

- `include_deleted` boolean
- `is_deployable_environments` boolean
- `items_per_page` integer: The number of items per page in the paginated list.
- `page` integer: The current page number in the paginated list.

## Response `200`

Successful Response

- ListEnvironmentsPaginationResponse: The list environments response to return as a paginated list
  - `next_page` string, nullable: The next page URL
  - `previous_page` string, nullable: The previous page URL
  - `page` integer: The page number
  - `current_page_size` integer, required: The current page size
  - `total_items` integer: The total number of entities fetched
  - `account_id` string, required: The account id
  - `items` EnvironmentsFields[], required
    - `_id` string, required: The environment id
    - `account` string, required: The account id of the user
    - `user_created` string, nullable: The user id of the user who first created the environment
    - `created_at` union: The environment creation date time in UTC timezone. Time format YYYY-MM-DDThh:mm:ss.ms
      - string, date-time
      - string
    - `cross_id` string, required: The cross id of the environment
    - `updated_at` union: The time in which the environment was last updated (UTC time zone)
      - string, date-time
      - string
    - `environment_name` string, required: The environment name
    - `color` 'gray.400' | 'tagGreen' | 'cBlues' | 'tagCyan' | 'tagGeekBlue' | 'cPurples' | 'tagPurple' | 'tagMagenta' | 'cOranges' | 'tagOrange' | 'yellow.200': The EnvironmentsColor enum provides all color options for environments
    - `description` string, nullable: The environment description
    - `variables` object, required: Environment's variables
    - `is_deleted` boolean, nullable: A flag that indicates whether the environment is deleted
    - `deleted_by` string, nullable: The user id of the user who deleted the environment (if the environment is deleted)
    - `deleted_at` union: The time in which the environment was deleted (if the environment is deleted). Time format YYYY-MM-DDThh:mm:ss.ms
      - string, date-time
      - string
    - `is_default` boolean: A flag that indicates whether the environment is the account's default environment
    - `updated_by` string, nullable: The user id of the user who last updated the environment
    - `is_delete_lock` boolean, nullable: A flag that indicates the environment deletion progress

## Other responses

- `422`: Validation Error

## Changes

> 577 revisions in range; 2 not diffed.

- **2026-11-09** `75e8c5d8f575`: 1 info
  - api tag `MCP` removed
- **2026-10-24** `00b90942c8d6`: 1 info
  - endpoint added
- **2026-10-24** `0a8241f415c4`: 1 breaking
  - api path removed without deprecation
- **2026-08-06** `ddd6b1c27983`: 2 info
  - api tag `MCP` added
  - the `is_default` response's property default value changed from `False` to `false` for the status `200`

[Operation history](https://skmtc.dev/rivery/apis/boomi-data-integration-api/changes/v1/accounts/:account_id/environments/get.md)

---

[API](https://skmtc.dev/rivery/apis/boomi-data-integration-api.md) - [All operations](https://skmtc.dev/rivery/apis/boomi-data-integration-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rivery/apis/boomi-data-integration-api/revisions/508ae10445c4?raw)