# List status page updates — API reference > Returns incidents, maintenance windows and reports configured as updates on a status page. Source: https://upfour.io/docs/api/status-pages/list-status-page-updates [Developers](https://upfour.io/docs/api.md)/[Status pages](https://upfour.io/docs/api/status-pages.md) Returns incidents, maintenance windows and reports configured as updates on a status page. GET https://app.upfour.io/v1/status-pages/{pageID}/updates scope status_page.read stable returns 200 ## Parameters | Field | Type | Description | | --- | --- | --- | | `pageID` required | uuid | path parameter | ## Returns A successful request returns `200` with application/json. Response fields 2 top-level fields | Field | Type | Description | | --- | --- | --- | | `data` | StatusPageUpdate[] · nullable | | | Each item · 38 fields FieldTypeDescription `affected_monitor_ids` uuid[] · nullable Monitors behind the affected components. `affected_resource_ids` uuid[] · nullable `auto_end` boolean `auto_start` boolean `created_at` string (date-time) `ends_at` string (date-time) · nullable `entries` StatusPageUpdateEntry[] · nullable Each item · 9 fields FieldTypeDescription `created_at` string (date-time) `id` uuid `message` string `notify_subscribers` boolean `published_at` string (date-time) `source` string one of`manual` `automatic` `status` string one of`investigating` `identified` `monitoring` `resolved` `scheduled` `in_progress` `completed` `cancelled` `published` `update_id` uuid `updated_at` string (date-time) `id` uuid `message` string Mirrors the latest entry. `monitor_mode` string one of`none` `pause_checks` `notify_subscribers` boolean `published_at` string (date-time) `recurrence` string one of`none` `weekly` `monthly` `recurrence_until` string (date) · nullable Last day of a recurring series (YYYY-MM-DD); null for no end. `reminder_minutes` integer · nullable `source` string one of`manual` `automatic` `starts_at` string (date-time) · nullable `status` string one of`investigating` `identified` `monitoring` `resolved` `scheduled` `in_progress` `completed` `cancelled` `published` Mirrors the latest entry. `status_page_id` uuid `timezone` string IANA time zone of a planned maintenance window; empty for other types. `title` string `update_type` string one of`incident` `maintenance` `report` `updated_at` string (date-time) `visibility` string one of`public` `draft` `closed_unmeasured` boolean Resolved, but the incident ended because monitoring resumed after a billing pause: nobody measured the recovery. `incident_group_id` uuid `incident_id` uuid `reminder_sent_at` string (date-time) `series_id` uuid | | | | `pagination` | Pagination | | | Pagination · 5 fields FieldTypeDescription `cursor` string · nullable `has_more` boolean `limit` integer 1–250 `next_cursor` string · nullable `prev_cursor` string · nullable | | | ## Errors Only the errors this operation can return. Every error uses the [same envelope](https://upfour.io/docs/api/responses.md). | Status | Code | Meaning | | --- | --- | --- | | 400 | [bad_request](https://upfour.io/docs/api/errors#code-bad_request) | The request is malformed or fails validation. | | 404 | [not_found](https://upfour.io/docs/api/errors#code-not_found) | The requested resource does not exist or is outside the caller's scope. | Every call can also return `unauthorized` (401), `rate_limit_exceeded` (429) or `internal_error` (500 / 502). See [Responses and errors](https://upfour.io/docs/api/responses.md). [PreviousUpdate a status page translation](https://upfour.io/docs/api/status-pages/update-a-status-page-translation.md) [NextCreate a status page update](https://upfour.io/docs/api/status-pages/create-a-status-page-update.md) ## Request ### cURL ```bash curl -s "https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/updates" \ -H "Authorization: Bearer $UP4_API_KEY" ``` ### JavaScript ```javascript const res = await fetch("https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/updates", { headers: { Authorization: `Bearer ${process.env.UP4_API_KEY}`, }, }); console.log(res.status, await res.json()); ``` ### Python ```python import os import requests res = requests.get( "https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/updates", headers={"Authorization": f"Bearer {os.environ['UP4_API_KEY']}"}, ) print(res.status_code, res.json()) ``` ### Go ```go package main import ( "fmt" "io" "net/http" "os" ) func main() { req, _ := http.NewRequest("GET", "https://app.upfour.io/v1/status-pages/00000000-0000-4000-8000-000000000001/updates", nil) req.Header.Set("Authorization", "Bearer "+os.Getenv("UP4_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() out, _ := io.ReadAll(res.Body) fmt.Println(res.StatusCode, string(out)) } ``` ### PHP ```php true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer " . getenv("UP4_API_KEY"), ], ]); $response = curl_exec($ch); echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), " ", $response, "\n"; curl_close($ch); ``` ## Response ### 200 ```json { "data": [ { "affected_monitor_ids": [], "affected_resource_ids": [], "auto_end": false, "auto_start": false, "created_at": "2026-10-27T09:00:00Z", "ends_at": null, "entries": [ { "created_at": "2026-10-27T09:00:00Z", "id": "00000000-0000-4000-8000-000000000002", "message": "We are looking into slow responses on the checkout.", "notify_subscribers": false, "published_at": "2026-10-27T09:00:00Z", "source": "manual", "status": "investigating", "update_id": "00000000-0000-4000-8000-000000000003", "updated_at": "2026-10-27T09:00:00Z" } ], "id": "00000000-0000-4000-8000-000000000003", "message": "We are looking into slow responses on the checkout.", "monitor_mode": "none", "notify_subscribers": false, "published_at": "2026-10-27T09:00:00Z", "recurrence": "none", "recurrence_until": null, "reminder_minutes": null, "source": "manual", "starts_at": null, "status": "investigating", "status_page_id": "00000000-0000-4000-8000-000000000001", "timezone": "", "title": "Checkout is slow", "update_type": "incident", "updated_at": "2026-10-27T09:00:00Z", "visibility": "public" } ], "pagination": { "cursor": null, "has_more": false, "limit": 50, "next_cursor": null, "prev_cursor": null } } ``` ### 400 ```json { "error": { "code": "bad_request", "message": "The request is malformed or fails validation.", "request_id": "req_…" } } ``` ### 404 ```json { "error": { "code": "not_found", "message": "The requested resource does not exist or is outside the caller's scope.", "request_id": "req_…" } } ```