## Retrieve

`client.riskEvents.retrieve(stringurn, RequestOptionsoptions?): RiskEventRetrieveResponse`

**get** `/v1/risk-events/{urn}`

Fetch in-depth information about a single risk event

### Parameters

- `urn: string`

### Returns

- `RiskEventRetrieveResponse`

  - `ai_risk_level_recommendation: AIRiskLevelRecommendation | null`

    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: "UNASSIGNED" | "NONE" | "LOW" | 3 more`

      The AI-recommended risk level for the event

      - `"UNASSIGNED"`

      - `"NONE"`

      - `"LOW"`

      - `"MEDIUM"`

      - `"HIGH"`

      - `"CRITICAL"`

  - `created_at: string`

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

  - `description: string | null`

    The risk event's description

  - `name: string`

    The risk event's display name

  - `review_status: "PENDING" | "VERIFYING" | "APPLICABLE" | "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: "UNASSIGNED" | "NONE" | "LOW" | 3 more`

    The finalized, user-determined risk level for the event (if set)

    - `"UNASSIGNED"`

    - `"NONE"`

    - `"LOW"`

    - `"MEDIUM"`

    - `"HIGH"`

    - `"CRITICAL"`

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

    The type of the risk event

    - `"STATUS_PAGE"`

    - `"MONITOR"`

    - `"NEWS"`

    - `"SEC_FILING"`

  - `url: string | null`

    A URL with more information about the risk event

  - `urn: string`

    A unique identifier for the risk event

  - `vendor: Vendor`

    Details about the vendor associated with this risk event.

    - `created_at: string`

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

    - `description: string | null`

      The vendor's description

    - `name: string`

      The vendor's display name

    - `urn: string`

      A unique identifier for the vendor

  - `category_tags?: Array<string> | null`

    Tags indicating the nature of the risk event.

### Example

```typescript
import Clarative from 'clarative';

const client = new Clarative({
  apiKey: process.env['CLARATIVE_API_KEY'], // This is the default and can be omitted
});

const riskEvent = await client.riskEvents.retrieve('urn');

console.log(riskEvent.ai_risk_level_recommendation);
```