Explore documentation

List existing reports on a status page

Returns a list of existing reports on your status page. This endpoint supports pagination.

GET https://uptime.betterstack.com/api/v2/status-pages/{status_page_id}/status-reports

URL parameters

status_page_id
required string

Headers

Authorization
required string
200

Response body

{
  "data": [
    {
      "id": "12345",
      "type": "status_report",
      "attributes": {
        "title": "Status report title",
        "report_type": "manual",
        "starts_at": "2021-12-08T15:05:24.000Z",
        "ends_at": null,
        "status_page_id": 123456,
        "affected_resources": [
          {
            "status_page_resource_id": "12345",
            "status": "downtime"
          }
        ],
        "aggregate_state": "downtime"
      },
      "relationships": {
        "status_updates": {
          "data": [
            {
              "id": "12345",
              "type": "status_update"
            }
          ]
        }
      }
    },
    {
      "id": "12346",
      "type": "status_report",
      "attributes": {
        "title": "Another status report title",
        "report_type": "manual",
        "starts_at": "2021-12-14T20:15:03.599Z",
        "ends_at": null,
        "status_page_id": 123456,
        "affected_resources": [
          {
            "status_page_resource_id": "12346",
            "status": "downtime"
          }
        ],
        "aggregate_state": "downtime"
      },
      "relationships": {
        "status_updates": {
          "data": [
            {
              "id": "12346",
              "type": "status_update"
            }
          ]
        }
      }
    }
  ],
  "pagination": {
    "first": "https://uptime.betterstack.com/api/v2/status-pages/123456/status-reports?page=1",
    "last": "https://uptime.betterstack.com/api/v2/status-pages/123456/status-reports?page=2",
    "prev": null,
    "next": "https://uptime.betterstack.com/api/v2/status-pages/123456/status-reports?page=2"
  }
}

Example cURL

Example
curl --request GET \
  --url https://uptime.betterstack.com/api/v2/status-pages/123456/status-reports \
  --header "Authorization: Bearer $TOKEN"