Skip to main content

​
Overview

The list_status_pages tool retrieves all status pages configured in your PagerDuty account. Status pages allow you to communicate service status and incidents to your customers and stakeholders.
This is a read-only tool that does not modify any data in your PagerDuty account.

​
Parameters

​
status_page_type
string
Filter status pages by type. Options:
  • public - Accessible to everyone
  • private - Requires authentication
  • audience_specific - Targeted to specific audiences
Example: "public"
​
limit
integer
default:"25"
Maximum number of results to return. Must be between 1 and 100.Example: 50

​
Response

Returns a list of status page objects.
​
response
array
Array of status page objects

​
Example Usage

"Show me all status pages"

​
Use Cases

  • Inventory status pages - View all status pages in your account
  • Find public pages - Identify which status pages are publicly accessible
  • Audit page types - Review the visibility settings of your status pages
  • Discover URLs - Get the URLs for your status pages
  • Verify publication - Check which status pages have been published

​
Response Example

{
  "response": [
    {
      "id": "PSTATUS1",
      "type": "status_page",
      "name": "ACME API Status",
      "status_page_type": "public",
      "url": "https://status.acme.com",
      "published_at": "2024-01-01T00:00:00Z"
    },
    {
      "id": "PSTATUS2",
      "type": "status_page",
      "name": "Internal Services Status",
      "status_page_type": "private",
      "url": "https://internal-status.acme.com",
      "published_at": "2024-01-15T10:00:00Z"
    }
  ]
}

​
Status Page Types Explained

​
Public

Anyone can view the status page without authentication. Ideal for external customer communication.

​
Private

Requires authentication to access. Best for internal team communication or sensitive information.

​
Audience Specific

Targeted to specific audiences or user groups. Useful for different customer tiers or partners.

Build docs developers (and LLMs) love

Get started for freeTalk to us