--- title: "List Applications - V2" method: GET path: "/api/v2/org/{orgId}/apps" tags: ["Applications"] --- # List Applications - V2 `GET /api/v2/org/{orgId}/apps` ## List Applications V2 Lists applications that belong to this organization. Returns a [**new style** paginated list](https://apidocs.stackhawk.com/docs/pagination-and-sorting) of Applications. | Parameter | Default | Description | |:---:|:---:|:---:| |orgId|""|The org id that these applications belong to.| |applications|[]|List of applications.| |totalCount|0|Total number of applications in the results.| |currentPage|{}|The current page.| |hasNext|false|Whether or not there is a next page.| |nextPage|{}|| |nextPageToken|""|| |hasPrev|false|Whether or not there is a previous page.| |prevPage|{}|| |prevPageToken|""|| ### Application Applications group scan results from HawkScan, and coordinate settings to influence HawkScan behavior. The application may also contain a specific environment name and id. For more information, see [Applications](https://docs.stackhawk.com/web-app/applications.html). | Parameter | Default | Description | |:---:|:---:|:---:| |applicationId|""|The UUID identifier of this application.| |name|""|The name of this application.| |env|""|The name of this environment. Only set when requesting Application Environments.| |envId|""|The UUID identifier of this environment.| |applicationStatus|"ACTIVE"|The status of this application. Either ACTIVE or ENV_INCOMPLETE.| |organizationId|""|The UUID identifier of the organization that owns this application.| |applicationType|"STANDARD"|The type of this application.| |cloudScanTarget|{}|Optional Cloud Scan Target configuration.| The returned list of applications is filtered by the organization id and User's API Token Team membership. ### Filter Query Params * `query`: A string to filter applications by name. * `appIds`: A comma-separated list of application uuids to filter by. * `teamIds`: A comma-separated list of team uuids to filter by. * `applicationStatus`: A comma-separated list of application statuses to filter by. Possible values are `ACTIVE` and `ENV_INCOMPLETE`. > Requires `read:application` permission. ## Path parameters - `orgId` string, uuid, required ## Query parameters - `query` string - `sortField` 'applicationId' | 'applicationName' | 'applicationStatus' | 'mappedRepositoryCount' | 'thirtyDayCommitActivity' - `sortDir` 'ASC' | 'DESC' | 'UNSORTED' - `page` string - `pageSize` integer - `pageToken` integer - `appIds` string[] - `teamIds` string[] - `applicationStatus` string[] - `applicationTypes` string[] ## Response `200` Paginated response of applications. - ApplicationViewListApplicationsResponseV2 — Paginated response of applications. - `applications` ApplicationApplication[] — List of applications. - `applicationId` string — The UUID identifier of this application. - `applicationStatus` 'ACTIVE' | 'ENV_INCOMPLETE' — The status of this application. Either ACTIVE or ENV_INCOMPLETE. - `applicationType` 'STANDARD' | 'CLOUD' — The type of this application. - `cloudScanTarget` ApplicationCloudScanTarget — Cloud Scan Target Configuration. - `isDomainVerified` boolean — Indicates if the domain is verified or not. - `targetURL` string — The target URL. - `dataType` 'NONE' | 'PII' | 'PCI' | 'FIN' | 'PKI' | 'HIPAA' | 'FERPA' — The perceived dataType of this application. Currently unused. - `env` string — The name of this environment. Only set when requesting Application Environments. - `envId` string — The UUID identifier of this environment. - `name` string — The name of this application. - `organizationId` string — The UUID identifier of the organization that owns this application. - `riskLevel` 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL' — The perceived riskLevel of this application. Currently unused. - `currentPage` PaginationPage - `filters` PaginationFilter[] — Generic filters that each type can define for its needs (isConnected=true, hasMapping=false, etc) - `multi` PaginationMultiValue - `values` string[] — The values of a given filter to filter on. - `name` string — The name of the filter to apply. - `value` string — A single value to filter on. - `number` integer — The page number to retrieve - 0 based - `query` string — The query string to filter the results. - `size` integer — the page size to retrieve. - `sortOptions` PaginationSortOptions - `direction` 'ASC' | 'DESC' | 'UNSORTED' — The direction to sort the results. - `field` string — Generic here, each type should define its own Enums + Converters - `hasNext` boolean — Whether or not there is a next page. - `hasPrev` boolean — Whether or not there is a previous page. - `nextPage` PaginationPage - `filters` PaginationFilter[] — Generic filters that each type can define for its needs (isConnected=true, hasMapping=false, etc) - `multi` PaginationMultiValue - `values` string[] — The values of a given filter to filter on. - `name` string — The name of the filter to apply. - `value` string — A single value to filter on. - `number` integer — The page number to retrieve - 0 based - `query` string — The query string to filter the results. - `size` integer — the page size to retrieve. - `sortOptions` PaginationSortOptions - `direction` 'ASC' | 'DESC' | 'UNSORTED' — The direction to sort the results. - `field` string — Generic here, each type should define its own Enums + Converters - `nextPageToken` string - `orgId` string — The org id that these applications belong to. - `prevPage` PaginationPage - `filters` PaginationFilter[] — Generic filters that each type can define for its needs (isConnected=true, hasMapping=false, etc) - `multi` PaginationMultiValue - `values` string[] — The values of a given filter to filter on. - `name` string — The name of the filter to apply. - `value` string — A single value to filter on. - `number` integer — The page number to retrieve - 0 based - `query` string — The query string to filter the results. - `size` integer — the page size to retrieve. - `sortOptions` PaginationSortOptions - `direction` 'ASC' | 'DESC' | 'UNSORTED' — The direction to sort the results. - `field` string — Generic here, each type should define its own Enums + Converters - `prevPageToken` string - `totalCount` integer — Total number of applications in the results. ## Other responses - `401` — Unauthorized --- [API](https://skmtc.net/stackhawk/apis/stackhawk-public-api.md) · [All operations](https://skmtc.net/stackhawk/apis/stackhawk-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stackhawk/stackhawk-public-api/versions/ad3dfd54cb63/schema)