> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plerion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# plerion risks

> View security risks identified by Plerion.

With **plerion risks**, you can view and filter security risks identified by Plerion, including severity, lifecycle state, and related asset details.

<Tip>
  For more about risks in the Plerion dashboard, see [Top risks](/guides/platform/top-risks).
</Tip>

***

## Synopsis

```bash theme={"system"}
plerion risks list [options]
```

***

## Subcommands

### list

List security risks with filtering and sorting.

```bash theme={"system"}
plerion risks list [options]
```

#### Options

| Flag | Type | Description |
| - | - | - |
| `--ids` | string | Filter by risk IDs (comma-separated) |
| `--risk-type-id` | string | Filter by risk type IDs (comma-separated) |
| `--primary-asset-id` | string | Filter by primary asset IDs (comma-separated) |
| `--severity` | string | `CRITICAL`, `HIGH`, `MEDIUM`, `LOW` |
| `--lifecycle-state` | string | `OPEN`, `DISMISSED_ACCEPTED`, `DISMISSED_NOT_A_RISK` |
| `--integration-id` | string | Filter by integration |
| `--environment-id` | string | Filter by environment |
| `--resource-type` | string | Filter by resource type |
| `--include` | string | Load relationships: `primaryAsset`, `integration` |
| `--fields` | string | Select specific fields to return (comma-separated) |
| `--discovered-at-start` | string | Discovered at start date (ISO 8601) |
| `--discovered-at-end` | string | Discovered at end date (ISO 8601) |
| `--sort-by` | string | `discoveredAt` or `score` |
| `--sort-order` | string | `asc` or `desc` |
| `--per-page` | number | Results per page (default: 50) |
| `--all` | flag | Fetch all pages automatically |

***

## Examples

```bash theme={"system"}
# Critical risks sorted by score
plerion risks list --severity CRITICAL --sort-by score --sort-order desc

# Open risks with asset details
plerion risks list --lifecycle-state OPEN --include primaryAsset

# Risks for a specific integration
plerion risks list --integration-id int-abc123 --output json

# Fetch all risks across all pages
plerion risks list --all --output json
```

***

## Output columns

Table output includes all fields returned by the API:

| Column | Description |
| - | - |
| ID | Risk ID |
| TYPE | Risk type ID |
| SEVERITY | `CRITICAL`, `HIGH`, `MEDIUM`, `LOW` |
| SCORE | Numeric risk score |
| LIKELIHOOD | Likelihood rating |
| IMPACT | Impact rating |
| STATE | Lifecycle state (`OPEN`, `DISMISSED_ACCEPTED`, `DISMISSED_NOT_A_RISK`) |
| DESCRIPTION | Risk description |
| PRIMARY ASSET ID | Primary affected asset ID |
| ASSET NAME | Primary asset name |
| RESOURCE TYPE | Resource type |
| FULL RESOURCE NAME | Full resource name |
| REGION | Cloud region |
| INTEGRATION ID | Integration ID |
| TENANT ID | Tenant ID |
| ORG ID | Organization ID |
| DISCOVERED AT | Discovery timestamp |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.