# List status page reports

Returns a list of existing reports on your status page. This endpoint [supports pagination](https://betterstack.com/docs/uptime/api/pagination/).

[endpoint]
base_url = "https://uptime.betterstack.com"
path = "/api/v2/status-pages/{status_page_id}/status-reports"
method = "GET"

[[path_param]]
name = "status_page_id"
description = "The ID of your status page"
required = true
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"

[/endpoint]

[responses]
[[response]]
status = 200
description = '''Returns a list of reports on your status page'''
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": "maintenance",
        "starts_at": "2021-12-14T20:15:00.000Z",
        "ends_at": "2021-12-14T21:00:00.000Z",
        "status_page_id": 123456,
        "affected_resources": [
          {
            "status_page_resource_id": "12346",
            "status": "maintenance"
          }
        ],
        "aggregate_state": "maintenance"
      },
      "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"
  }
}'''
[/responses]

#### Example cURL 

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

[info]
#### Looking for the details of a specific parameter?
Explore [the list of all status page reports API parameters](https://betterstack.com/docs/uptime/api/status-page-reports-api-response-params/)
[/info]