List Status Page Posts

List Posts for a Status Page by Status Page ID.

Scoped OAuth requires: status_pages.read

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

Query Parameters

post_type?string

Filter by Post type.

Value in

"incident"
"maintenance"

reviewed_status?string

Filter by the reviewed status of the Post to retrieve.

Value in

"approved"
"not_reviewed"

status[]?array<string>

Filter by an array of Status identifiers.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Response Body

`application/json`

curl -X GET "https://example.com/status_pages/{id}/posts" \  -H "Accept: application/vnd.pagerduty+json;version=2"

{  "limit": 25,  "more": false,  "offset": 0,  "posts": [    {      "ends_at": "2023-12-12T11:00:00.000Z",      "id": "PIJ90N7",      "post_type": "maintenance",      "postmortem": {        "id": "PWZ0PTR",        "self": "https://api.pagerduty.com/status_pages/PR5LMML/posts/PIJ90N7/postmortem",        "type": "status_page_postmortem"      },      "self": "https://api.pagerduty.com/status_pages/PR5LMML/posts/PIJ90N7",      "starts_at": "2023-12-12T11:00:00.000Z",      "status_page": {        "id": "PR5LMML",        "type": "status_page"      },      "title": "maintenance window for database upgrade",      "type": "status_page_post",      "updates": [        {          "id": "P7HUBBZ",          "self": "https://api.pagerduty.com/status_pages/PR5LMML/posts/PIJ90N7/post_updates/P7HUBBZ",          "type": "status_page_post_update"        }      ]    }  ],  "total": 3}

List Status Page Posts

Authorization

Path Parameters

Query Parameters

Header Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`