## Retrieve Violation

**get** `/v1/slas/{sla_urn}/violations/{violation_urn}`

Get details on a specific SLA violation

### Path Parameters

- `sla_urn: string`

- `violation_urn: string`

### Returns

- `allowable_downtime_hours: number`

  The total number of allowable downtime hours during the evaluation period, as defined by the SLA's terms

- `data_source: object { excluded_product_tags, included_product_tags, urn, data_source_type }  or object { description, name, urn, data_source_type }`

  The data source used to determine the violation.

  - `APIStatusPageSlaDataSource = object { excluded_product_tags, included_product_tags, urn, data_source_type }`

    - `excluded_product_tags: array of string`

      A list of incident tags that are excluded from the SLA's calculations

    - `included_product_tags: array of string`

      A list of incident tags that are included in the SLA's calculations

    - `urn: string`

      A unique identifier for the data source

    - `data_source_type: optional "STATUS_PAGE"`

      The type of the data source

      - `"STATUS_PAGE"`

  - `APIMonitorSlaDataSource = object { description, name, urn, data_source_type }`

    - `description: string`

      The monitor's description

    - `name: string`

      The monitor's display name

    - `urn: string`

      A unique identifier for the data source

    - `data_source_type: optional "MONITOR"`

      The type of the data source

      - `"MONITOR"`

- `data_source_type: "STATUS_PAGE" or "MONITOR"`

  The type of data source used to determine the violation.

  - `"STATUS_PAGE"`

  - `"MONITOR"`

- `downtime_events: array of object { duration_hours, end_time, name, start_time }`

  A list of downtime events that occurred during the evaluation period and contributed to the SLA violation

  - `duration_hours: number`

    The duration of the downtime event in hours

  - `end_time: string`

    The end time of the downtime event

  - `name: string`

    The display name of the downtime event

  - `start_time: string`

    The start time of the downtime event

- `downtime_hours: number`

  The total number of downtime hours during the evaluation period

- `evaluation_period: object { end_month, start_month }`

  The evaluation period during which the SLA violation occurred. The length of the period is determined by the SLA's configured evaluation window (for example: monthly or quarterly).

  - `end_month: object { month, year }`

    The month in which the SLA violation ended. Null if the violation is ongoing.

    - `month: number`

      The month number (1-12)

    - `year: number`

      The year of the month

  - `start_month: object { month, year }`

    The month in which the SLA violation started

    - `month: number`

      The month number (1-12)

    - `year: number`

      The year of the month

- `sla: object { description, name, urn, vendor_urn }`

  The SLA that was violated

  - `description: string`

    A description of the SLA

  - `name: string`

    The name of the SLA

  - `urn: string`

    A unique identifier for the SLA

  - `vendor_urn: string`

    A unique identifier for the vendor associated with the SLA

- `uptime_percentage: number`

  The percentage of uptime during the evaluation period

- `urn: string`

  A unique identifier composed of the SLA URN and the evaluation period

- `vendor: object { created_at, description, name, urn }`

  The vendor responsible for the violation

  - `created_at: string`

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

  - `description: string`

    The vendor's description

  - `name: string`

    The vendor's display name

  - `urn: string`

    A unique identifier for the vendor

### Example

```http
curl https://developer.clarative.ai/v1/slas/$SLA_URN/violations/$VIOLATION_URN \
    -H "Authorization: Bearer $CLARATIVE_API_KEY"
```