---
title: "Gets the status of an environment"
method: GET
path: "/monitoring/{owner}/environments/{environment}/status"
tags: ["monitoring"]
---

# Gets the status of an environment

`GET /monitoring/{owner}/environments/{environment}/status`

## Path parameters

- `owner` string, required
- `environment` string, required

## Query parameters

- `eventLimit` integer
- `refresh` boolean

## Response `200`

The status of the environment

- DispatchInfo
  - `launchedCapsuleReference` OwnedResourceReference
    - `owner` string
    - `name` string
    - `version` string
  - `launchingUser` string
  - `dispatchId` string
  - `state` 'UNKNOWN' | 'PENDING' | 'RUNNING' | 'TERMINATING' | 'MISSING' | 'TERMINATED' | 'COMPLETED' | 'FAILED'
  - `events` Event[]
    - `level` 'TRACE' | 'DEBUG' | 'INFO' | 'WARNING' | 'ERROR'
    - `timestamp` string
    - `reporter` string
    - `message` string
    - `extraInfo` object
    - `additionalProperties` object
  - `lastUpdated` string
  - `payloadStates` object
  - `additionalProperties` object

## Other responses

- `403` — User does not have permission to view environments with the given owner
- `404` — The specified environment does not exist

---

[API](https://skmtc.dev/determined-ai/apis/launcher-api.md) · [All operations](https://skmtc.dev/determined-ai/apis/launcher-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/determined-ai/launcher-api/revisions/33885ccfb9ac/schema)