# Get Outages from 3rd-party Monitors

The Incidents endpoint is used to get the outages that happen in service in the last month. Depending on your plan, you will have access via API to all the services available or just the services you monitor.

## Get outages information of a service for the last 30 days

<mark style="color:blue;">`GET`</mark> `https://isdown.app/api/v2/services/{service_name}/incidents`

#### Path Parameters

| Name                                            | Type   | Description                                                                                                                                                 |
| ----------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| service\_name<mark style="color:red;">\*</mark> | String | Parameterize name for the service. Get the service\_name from the url of a service. E.g., <https://isdown.app/services/digitalocean> it's **digitalocean.** |

#### Query Parameters

| Name                   | Type   | Description                                                  |
| ---------------------- | ------ | ------------------------------------------------------------ |
| include\_user\_reports | String | If 'true' it will return incidents created from user reports |

#### Headers

| Name                                            | Type   | Description     |
| ----------------------------------------------- | ------ | --------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer API\_KEY |

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "data": [
        {
            "id": "1",
            "type": "incident",
            "attributes": {
                "url": null,
                "title": "Users reports spike",
                "description": null,
                "status": "minor",
                "resolved": false,
                "created_at": "2023-05-23T17:08:12.942Z",
                "resolved_at": null,
                "service": "AWS",
                "user_generated": true
                "components": []
            }
        },
        {
            "id": "2",
            "type": "incident",
            "attributes": {
                "url": null,
                "title": "Data discrepancy Issue",
                "description": "We are investigating data discrepancy issues with Billing Console. Customers using Cost Explorer, Cost and Usage Report, Saving Plans and Reservations Utilization and Coverage Reports consoles may experience data staleness. We are actively working towards resolution and we expect to be able to provide an update by 7:30 AM PDT.",
                "status": "minor",
                "resolved": true,
                "created_at": "2023-08-14T13:39:00.000Z",
                "resolved_at": "2023-08-14T18:38:22.338Z",
                "service": "AWS",
                "user_generated": false,
                "components": [
                    "AWS Billing Console"
                ]
            }
        },
    ]
}
```

{% endtab %}

{% tab title="401: Unauthorized When authorization is missing or is invalid" %}

```json
{
    "errors": [
        {
            "status": 401,
            "title": "Unauthorized access",
            "detail": "You are not authorized to access this resource"
        }
    ]
}
```

{% endtab %}

{% tab title="404: Not Found When we don't find the resource" %}

```json
{
    "errors": [
        {
            "status": 404,
            "title": "Resource not found",
            "detail": "The resource you are looking for does not exist"
        }
    ]
}
```

{% endtab %}
{% endtabs %}