---
title: "List Environments"
method: GET
path: "/api/v1/app/{appId}/env/list"
tags: ["Applications"]
deprecated: true
---

# List Environments

`GET /api/v1/app/{appId}/env/list`

> **Deprecated.**

## List Environments

**First time here?** - use our [V2 environments](ref:listenvsv2) API instead!

Lists environments that belong to this application.

Returns a [paginated list](https://apidocs.stackhawk.com/docs/pagination-and-sorting) of Environments.

| Parameter | Default | Description |
|:---:|:---:|:---:|
|environments|[]|List of environments.|
|nextPageToken|""|PageToken to provide for the next page of results.|
|totalCount|0|Total number of results.|

### Environment

An Application-environment with details of recent scan stats included.

| Parameter | Default | Description |
|:---:|:---:|:---:|
|environmentName|""|The name of this environment.|
|environmentId|""|The UUID identifier of this environment.|
|currentScanSummary|{}|Summary of the scan results and triaged findings for this environment.|
|latestScanType|"UNKNOWN"|Type of newest scan in this environment. Options include `DEFAULT`, `REST`, `GRAPHQL`, `GRPC`, `SOAP`.|

### Scan Summary

The summary of findings from scan results.

| Parameter | Default | Description |
|:---:|:---:|:---:|
|configHash|""|Hash of the HawkScan configuration used for this scan.|
|timestamp|0|Seconds since unix epoch timestamp of when the scan was started.|
|alertStats|{}|Summarized statistics of findings for this scan.|
|version|""|The version of HawkScan used for this scan.|
|scanId|""|The UUID identifier of this scan.|
|applicationId|""|The UUID identifier of this scan's application.|

The returned list of environments is filtered by the User's API Token Team membership.


> Requires `read:application` permission.

## Path parameters

- `appId` string, uuid, required

## Query parameters

- `envs` string[]
- `pageSize` integer
- `pageToken` integer
- `sortField` 'id' | 'name'
- `sortDir` 'asc' | 'desc'

## Response `200`

Paginated response of environments.

- ApplicationListEnvironmentsResponse — Paginated response of environments.
  - `environments` ApplicationEnvironment[] — List of environments.
    - `currentScanSummary` ApplicationScanSummary — The summary of findings from scan results.
      - `alertStats` ApplicationScanAlertStats — A summary of alert statistics from a run of HawkScan.
        - `alertStatusStats` ApplicationAlertStatusStats[] — Statistics for findings of this scan by severity and triage status.
          - `alertStatus` 'UNKNOWN' | 'FALSE_POSITIVE' | 'RISK_ACCEPTED' | 'PROMOTED' | 'ADD_COMMENT' — Triage status of this scan alert.
          - `severityStats` object — A map of finding counts by severity ("High" "Medium" "Low")
          - `totalCount` integer — Total number of findings on paths
        - `totalAlerts` integer — The total number of findings from the scan.
        - `uniqueAlerts` integer — The total number of unique findings across all paths in the scan.
      - `applicationId` string — The UUID identifier of this scan's application.
      - `configHash` string — Hash of the HawkScan configuration used for this scan.
      - `scanId` string — The UUID identifier of this scan.
      - `timestamp` integer — Seconds since unix epoch timestamp of when the scan was started.
      - `version` string — The version of HawkScan used for this scan.
    - `environmentId` string — The UUID identifier of this environment.
    - `environmentName` string — The name of this environment.
    - `latestScanType` 'DEFAULT' | 'REST' | 'GRAPHQL' | 'GRPC' | 'SOAP' — Type of newest scan in this environment. Options include `DEFAULT`, `REST`, `GRAPHQL`, `GRPC`, `SOAP`.
    - `scanSummaries` ApplicationScanSummary[] — Summaries of recent scans from this environment.
      - `alertStats` ApplicationScanAlertStats — A summary of alert statistics from a run of HawkScan.
        - `alertStatusStats` ApplicationAlertStatusStats[] — Statistics for findings of this scan by severity and triage status.
          - `alertStatus` 'UNKNOWN' | 'FALSE_POSITIVE' | 'RISK_ACCEPTED' | 'PROMOTED' | 'ADD_COMMENT' — Triage status of this scan alert.
          - `severityStats` object — A map of finding counts by severity ("High" "Medium" "Low")
          - `totalCount` integer — Total number of findings on paths
        - `totalAlerts` integer — The total number of findings from the scan.
        - `uniqueAlerts` integer — The total number of unique findings across all paths in the scan.
      - `applicationId` string — The UUID identifier of this scan's application.
      - `configHash` string — Hash of the HawkScan configuration used for this scan.
      - `scanId` string — The UUID identifier of this scan.
      - `timestamp` integer — Seconds since unix epoch timestamp of when the scan was started.
      - `version` string — The version of HawkScan used for this scan.
  - `nextPageToken` string — PageToken to provide for the next page of results.
  - `totalCount` integer — Total number of results.

## Other responses

- `401` — Unauthorized

---

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