Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. AI SRE investigations
    3. Post mortems
    4. Metadata & Catalog
    5. Screening alerts
    6. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
    6. Status pages
      1. Status pages API
      2. Status page groups
      3. Status page sections
      4. Status page resources
      5. Status page subscribers
      6. Status page reports
      7. Status page report updates
        1. List status updates per report GET
        2. Get status update GET
        3. Create status update POST
        4. Update status update PATCH
        5. Remove status update DELETE
    7. Metadata
    8. Integrations
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Get status update

Returns a single status page report update.

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

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

status_update_id
required string

The ID of your status update

Headers

Authorization
required string

Bearer $TOKEN

200

Returns the requested status update.

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": false,
      "status_report_id": 12345,
      "affected_resources": [
        {
          "status_page_resource_id": "12345",
          "status": "degraded"
        }
      ]
    }
  }
}

Response attributes

id
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.

Example cURL

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


Previous article

List status updates per report

Next article

Create status update