List status updates per report

Returns a list of status updates for your status page report.

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

URL parameters

status_page_id

required string

The ID of your status page

status_report_id

required string

The ID of your status page report

Query parameters

page

integer

The page number to return, starting with 1.

per_page

integer

Number of results per page. Defaults to 50, maximum 250.

Headers

Authorization

required string

Bearer $TOKEN

200

Returns a list of status updates for your status page report.

Response body

{
  "data": [
    {
      "id": "123456",
      "type": "status_update",
      "attributes": {
        "message": "First status update message",
        "published_at": "2021-12-16T16:04:09.880Z",
        "published_at_timezone": "UTC",
        "notify_subscribers": true,
        "status_report_id": 12345,
        "affected_resources": [
          {
            "status_page_resource_id": "12345",
            "status": "degraded"
          }
        ]
      }
    },
    {
      "id": "123457",
      "type": "status_update",
      "attributes": {
        "message": "Second status update message",
        "published_at": "2021-12-16T16:35:16.627Z",
        "published_at_timezone": "UTC",
        "notify_subscribers": false,
        "status_report_id": 12345,
        "affected_resources": [
          {
            "status_page_resource_id": "12345",
            "status": "downtime"
          }
        ]
      }
    }
  ],
  "pagination": {
    "first": "https://incidents.betterstack.com/api/v2/status-pages/123456/status-reports/12345/status-updates?page=1",
    "last": "https://incidents.betterstack.com/api/v2/status-pages/123456/status-reports/12345/status-updates?page=1",
    "prev": null,
    "next": null
  }
}

Response attributes

string

The ID of the status update.

type

string

Always status_update.

attributes.message

string

The message of the status update.

attributes.published_at

string

When the status update was published, in ISO 8601 format.

attributes.published_at_timezone

string or null

The time zone published_at was entered in on the dashboard. null for an update posted through the API.

attributes.notify_subscribers

boolean

Whether subscribers of the status page get an e-mail about this update.

attributes.status_report_id

integer

The ID of the status page report this update belongs to.

attributes.affected_resources

array

The status each resource had in this update. Empty for a maintenance report's updates.

attributes.affected_resources[].status_page_resource_id

string

The ID of the affected status page resource.

attributes.affected_resources[].status

string

The status of the resource in this update: downtime, degraded, or resolved.

pagination.first

string

The URL of the first page. Read more about pagination.

pagination.last

string

The URL of the last page.

pagination.prev

string or null

The URL of the previous page, or null on the first page.

pagination.next

string or null

The URL of the next page, or null on the last page.

Example cURL

Example

Copied!

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

Remove status page report

Get status update

Explore documentation

List status updates per report

Example cURL

Please accept cookies