## List Violations

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

List all violations for an SLA

### Path Parameters

- `sla_urn: string`

### Query Parameters

- `data_source_urn: optional string`

  An SLA data source's unique identifier

- `timeframe_end: optional string`

  Year and month landing within the last SLA evaluation period to include in the result, in the format YYYY-MM

- `timeframe_start: optional string`

  Year and month landing within the first SLA evaluation period to include in the result, in the format YYYY-MM

### 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_type: "STATUS_PAGE" or "MONITOR"`

  The type of data source used to determine the violation.

  - `"STATUS_PAGE"`

  - `"MONITOR"`

- `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

- `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

### Example

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