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

GET https://isdown.app/api/v2/services/{service_name}/incidents

Path Parameters

Name	Type	Description
service_name*	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*	String	Bearer API_KEY

200: OK

{
    "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"
                ]
            }
        },
    ]
}

401: Unauthorized When authorization is missing or is invalid

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

404: Not Found When we don't find the resource

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