## List

**get** `/v1/risk-events`

List all risk events with optional filters

### Query Parameters

- `risk_threshold: optional "LOW" or "MEDIUM" or "HIGH" or "CRITICAL"`

  Risk level classification for a risk event.

  * LOW: Minimal impact.
  * MEDIUM: Moderate impact, may require attention.
  * HIGH: Significant impact, likely requires action.
  * CRITICAL: Severe impact, requires immediate action. It is rare to encounter this.

  - `"LOW"`

  - `"MEDIUM"`

  - `"HIGH"`

  - `"CRITICAL"`

- `vendor_urn: optional string`

  A vendor's unique identifier

### Returns

- `ai_risk_level_recommendation: object { explanation, recommended_risk_level }`

  AI's risk level recommendation for this event, if available. AI recommendations are made automatically, shortly after a risk event is discovered.

  - `explanation: string`

    The explanation for the AI's risk level recommendation

  - `recommended_risk_level: "LOW" or "MEDIUM" or "HIGH" or "CRITICAL"`

    The AI-recommended risk level for the event

    - `"LOW"`

    - `"MEDIUM"`

    - `"HIGH"`

    - `"CRITICAL"`

- `created_at: string`

  An ISO-8601-formatted timestamp representing when the risk event was created (UTC)

- `description: string`

  The risk event's description

- `name: string`

  The risk event's display name

- `review_status: "PENDING" or "VERIFYING" or "APPLICABLE" or "NOT_APPLICABLE"`

  The current review status of the risk event, representing where it is in the triage process.

  - `"PENDING"`

  - `"VERIFYING"`

  - `"APPLICABLE"`

  - `"NOT_APPLICABLE"`

- `risk_level: "LOW" or "MEDIUM" or "HIGH" or "CRITICAL"`

  Risk level classification for a risk event.

  * LOW: Minimal impact.
  * MEDIUM: Moderate impact, may require attention.
  * HIGH: Significant impact, likely requires action.
  * CRITICAL: Severe impact, requires immediate action. It is rare to encounter this.

  - `"LOW"`

  - `"MEDIUM"`

  - `"HIGH"`

  - `"CRITICAL"`

- `source_type: "STATUS_PAGE" or "MONITOR" or "NEWS" or "SEC_FILING"`

  The type of the risk event

  - `"STATUS_PAGE"`

  - `"MONITOR"`

  - `"NEWS"`

  - `"SEC_FILING"`

- `url: string`

  A URL with more information about the risk event

- `urn: string`

  A unique identifier for the risk event

### Example

```http
curl https://developer.clarative.ai/v1/risk-events \
    -H "Authorization: Bearer $CLARATIVE_API_KEY"
```