Custom Monitors

The Custom Monitor endpoint is used to get the current status of all custom monitors in your account.

Get the complete list of your custom monitors

GET https://isdown.app/api/v2/custom_monitors

Headers

Name	Type	Description
Authorization*	String	Bearer API_KEY

200: OK List of all the services

{
    "data": [
        {
            "id": "1",
            "type": "custom_monitor",
            "attributes": {
                "name": "IsDown",
                "status": "ok",
                "url": "https://isdown.app",
                "probe_type": "ping",
                "created_at": "2024-08-16T16:36:25.952Z",
                "updated_at": "2024-09-09T11:32:13.647Z",
                "ongoing_incidents": {
                    "data": []
                }
            }
        },
        {
            "id": "2",
            "type": "custom_monitor",
            "attributes": {
                "name": "IsDown Keyword",
                "status": "down",
                "url": "https://isdown.app",
                "probe_type": "keyword",
                "created_at": "2024-08-16T16:36:25.952Z",
                "updated_at": "2024-09-09T11:32:13.647Z",
                "ongoing_incidents": {
                    "data": [
                        {
                            "id": "2",
                            "type": "custom_monitor_incident",
                            "attributes": {
                                "description": "Down in Europe, North America with HTTP status code 500",
                                "created_at": "2024-09-09T10:08:11.500Z",
                                "resolved_at": null,
                                "updated_at": "2024-09-09T11:32:13.647Z",
                                "resolved": false
                            }
                        }
                    ]
                }
            }
        },
        ...
    ]
n

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

200: OK When status is any other than OK

{
    "data": [
        {
            "id": "1",
            "type": "custom_monitor",
            "attributes": {
                "name": "IsDown",
                "status": "ok",
                "url": "https://isdown.app",
                "probe_type": "ping",
                "created_at": "2024-08-16T16:36:25.952Z",
                "updated_at": "2024-09-09T11:32:13.647Z",
                "ongoing_incidents": {
                    "data": []
                }
            }
        },
        ...
    ]
n