---
title: "List Status Page Posts"
method: GET
path: "/status_pages/{id}/posts"
tags: ["Status Pages"]
---

# List Status Page Posts

`GET /status_pages/{id}/posts`

List Posts for a Status Page by Status Page ID.

Scoped OAuth requires: `status_pages.read`

## Path parameters

- `id` string, required

## Query parameters

- `post_type` 'incident' | 'maintenance'
- `reviewed_status` 'approved' | 'not_reviewed'
- `status[]` string[]

## Headers

- `Accept` string, required

## Response `200`

OK

- object
  - `offset` integer — Echoes offset pagination property.
  - `limit` integer — Echoes limit pagination property.
  - `more` boolean — Indicates if there are additional records to return
  - `total` integer, nullable — The total number of records matching the given query.
  - `posts` StatusPagePost[]
    - `id` string — An unique identifier within Status Page scope that defines a single Post resource.
    - `self` string — The API resource URL of the Post.
    - `type` string — The type of the object returned by the API - in this case, a Status Page Post.
    - `post_type` 'incident' | 'maintenance' — The type of the Post.
    - `status_page` object — Status Page
      - `id` string, required — Status page unique identifier
      - `type` string — A string that determines the schema of the object.
    - `linked_resource` object — Linked resource
      - `id` string, required — Linked resource unique identifier
      - `type` string — A string that determines the schema of the object.
    - `postmortem` object — Postmortem
      - `id` string, required — Postmortem unique identifier
      - `type` string — A string that determines the schema of the object.
    - `title` string — The title given to a Post.
    - `starts_at` string, date-time, nullable — The date and time the Post intent becomes effective - only for maintenance post type.
    - `ends_at` string, date-time, nullable — The date and time the Post intent is concluded - only for maintenance post type.
    - `updates` object[] — List of status_page_post_update references associated to a Post.
      - `id` string — The ID of the Post Update.
      - `self` string — The path to which the Post Update resource is accessible.
      - `post` object — Status Page Post
        - `id` string, required — Status page post unique identifier
        - `type` string — A string that determines the schema of the object.
      - `message` string — The message of the Post Update.
      - `reviewed_status` 'approved' | 'not_reviewed' — The status of the Post Updates to retrieve.
      - `status` object — Status Page Status
        - `id` string, required — Status page Status unique identifier
        - `type` string — A string that determines the schema of the object.
      - `severity` object — Status Page Severity
        - `id` string, required — Status page Severity unique identifier
        - `type` string — A string that determines the schema of the object.
      - `impacted_services` object[] — Impacted services represent the status page services affected by a post update, and its impact.
        - `service` object — Status Page Service
          - `id` string — An unique identifier within Status Page scope that defines a Service entry.
          - `type` string — The type of the object returned by the API - in this case, a Status Page Service.
        - `impact` object — Status Page Impact
          - `id` string — An unique identifier within Status Page scope that defines a Status Page Impact entry.
          - `type` string — The type of the object returned by the API - in this case, a Status Page Impact.
      - `update_frequency_ms` integer, nullable — The frequency of the next Post Update in milliseconds.
      - `notify_subscribers` boolean — Determines if the subscribers should be notified of the Post Update.
      - `reported_at` string, date-time, nullable — The date and time the Post Update was reported.
      - `type` string — The type of the object returned by the API - in this case, a Status Page Post Update.

## Other responses

- `400` — Caller provided invalid arguments. Please review the response for error details. Retrying with the same arguments will *not* work.
- `401` — Caller did not supply credentials or did not provide the correct credentials. If you are using an API key, it may be invalid or your Authorization header may be malformed.
- `403` — Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.
- `404` — The requested resource was not found.
- `429` — Too many requests have been made, the rate limit has been reached.

---

[API](https://skmtc.net/pagerduty/apis/rest-api.md) · [All operations](https://skmtc.net/pagerduty/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagerduty/rest-api/versions/b679a8f3f02c/schema)