---
title: "Retrieve environment"
method: GET
path: "/environments/{environmentId}"
tags: ["Projects & Environments"]
---

# Retrieve environment

`GET /environments/{environmentId}`

Retrieve the environment with the provided ID.

## Path parameters

- `environmentId` string, required

## Response `200`

Successful response

- Environment
  - `id` string, required
  - `name` string, required
  - `projectId` string, required
  - `databasesIds` string[], required
  - `ipAllowList` CidrBlockAndDescription[]
    - `cidrBlock` string, required
    - `description` string, required — User-provided description of the CIDR block
  - `redisIds` string[], required
  - `serviceIds` string[], required
  - `envGroupIds` string[], required
  - `protectedStatus` 'unprotected' | 'protected', required — Indicates whether an environment is `unprotected` or `protected`. Only admin users can perform destructive actions in `protected` environments.
  - `networkIsolationEnabled` boolean, required — Indicates whether network connections across environments are allowed.

## Other responses

- `400` — The request could not be understood by the server.
- `401` — Authorization information is missing or invalid.
- `404` — Unable to find the requested resource.
- `429` — Rate limit has been surpassed.
- `500` — An unexpected server error has occurred.
- `503` — Server currently unavailable.

---

[API](https://skmtc.dev/render/apis/render-public-api.md) · [All operations](https://skmtc.dev/render/apis/render-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/render/render-public-api/revisions/80e0ff74d033/schema)