> ## Documentation Index > Fetch the complete documentation index at: https://docs.sazabi.com/llms.txt > Use this file to discover all available pages before exploring further. # Read a public status page > Read a published status page without authentication: surfaces with current status and 90 days of uptime, open reports, upcoming maintenance and the 20 most recent resolved reports. Returns 404 for hidden, suspended, deleted and unknown slugs alike. ## OpenAPI ````yaml /openapi.json get /public/status-pages/{slug} openapi: 3.1.1 info: title: Sazabi Public API version: 1.0.0 description: > Public REST API for Sazabi. Authenticate using a secret API key in the Authorization header. ## Pagination This API uses two pagination strategies depending on the endpoint type: ### Cursor-Based Pagination (List Endpoints) List endpoints (threads, messages, keys) use cursor-based pagination for efficient, consistent results: - **Parameters**: `limit` (items per page, default 50, max 100), `cursor` (opaque pagination token) - **Response**: Includes `nextCursor` field - pass this as `cursor` in the next request - **End of results**: When `nextCursor` is `null`, there are no more results - **Example**: `GET /v1/threads?limit=20&cursor=01234567-89ab-cdef-0123-456789abcdef` ### Page-Based Pagination (Search Endpoints) Search endpoints use page-based pagination due to the underlying search engine: - **Parameters**: `limit` (items per page, default 20, max 100), `page` (1-indexed page number) - **Response**: Includes `pagination` object with `page`, `limit`, `totalResults`, `totalPages` - **Example**: `GET /v1/search/threads?q=error&limit=10&page=2` servers: - url: https://api.sazabi.com/v1 description: Production security: [] paths: /public/status-pages/{slug}: get: tags: - StatusPages summary: Read a public status page description: >- Read a published status page without authentication: surfaces with current status and 90 days of uptime, open reports, upcoming maintenance and the 20 most recent resolved reports. Returns 404 for hidden, suspended, deleted and unknown slugs alike. operationId: statusPages.public.get parameters: - name: slug in: path required: true schema: type: string pattern: ^[a-z0-9](?:[a-z0-9-]{1,38})[a-z0-9]$ description: >- The page's DNS label on sazabi.page: 3-40 lowercase letters, digits and inner hyphens. Unique across Sazabi. responses: '200': description: OK content: application/json: schema: type: object properties: page: type: object properties: slug: type: string title: type: string description: anyOf: - type: string - type: 'null' logoUrl: anyOf: - type: string - type: 'null' accentColor: anyOf: - type: string - type: 'null' theme: enum: - light - dark - system type: string description: Color scheme the public page renders with. supportUrl: anyOf: - type: string - type: 'null' timezone: type: string url: type: string required: - slug - title - description - logoUrl - accentColor - theme - supportUrl - timezone - url status: enum: - operational - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: 'The page''s overall status: its worst surface status.' sections: type: array items: type: object properties: key: type: string name: type: string description: anyOf: - type: string - type: 'null' collapsedByDefault: type: boolean status: enum: - operational - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: >- A surface's current status: the worst impact named by the latest published update of each open published report, else operational. surfaces: type: array items: type: object properties: key: type: string name: type: string description: anyOf: - type: string - type: 'null' status: enum: - operational - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: >- A surface's current status: the worst impact named by the latest published update of each open published report, else operational. uptime: anyOf: - type: object properties: percent: type: number description: >- Share of the last 90 days (since the surface was added, if later) not spent in partial or major outage. days: type: array items: type: object properties: date: type: string description: UTC day, YYYY-MM-DD. status: enum: - operational - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: >- The worst status the surface had that day. downtimeMinutes: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Minutes in partial_outage or major_outage that day. required: - date - status - downtimeMinutes required: - percent - days - type: 'null' description: >- Null when the page hides uptime for this surface. required: - key - name - description - status - uptime required: - key - name - description - collapsedByDefault - status - surfaces surfaces: type: array items: type: object properties: key: type: string name: type: string description: anyOf: - type: string - type: 'null' status: enum: - operational - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: >- A surface's current status: the worst impact named by the latest published update of each open published report, else operational. uptime: anyOf: - type: object properties: percent: type: number description: >- Share of the last 90 days (since the surface was added, if later) not spent in partial or major outage. days: type: array items: type: object properties: date: type: string description: UTC day, YYYY-MM-DD. status: enum: - operational - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: >- The worst status the surface had that day. downtimeMinutes: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Minutes in partial_outage or major_outage that day. required: - date - status - downtimeMinutes required: - percent - days - type: 'null' description: Null when the page hides uptime for this surface. required: - key - name - description - status - uptime description: Surfaces at the page's top level. activeReports: type: array items: type: object properties: id: type: string format: uuid kind: enum: - incident - maintenance type: string title: type: string state: enum: - investigating - identified - monitoring - resolved - scheduled - in_progress - completed type: string description: >- Incidents move through investigating, identified, monitoring and resolved; maintenance through scheduled, in_progress and completed. startedAt: type: string format: date-time resolvedAt: anyOf: - type: string format: date-time - type: 'null' scheduledStartAt: anyOf: - type: string format: date-time - type: 'null' scheduledEndAt: anyOf: - type: string format: date-time - type: 'null' impacts: type: array items: type: object properties: surfaceKey: type: string surfaceName: type: string impact: anyOf: - enum: - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: How a report affects a surface. - type: 'null' required: - surfaceKey - surfaceName - impact description: >- What the latest published update says the report affects. updates: type: array items: type: object properties: id: type: string format: uuid state: enum: - investigating - identified - monitoring - resolved - scheduled - in_progress - completed type: string description: >- Incidents move through investigating, identified, monitoring and resolved; maintenance through scheduled, in_progress and completed. message: type: string publishedAt: type: string format: date-time impacts: type: array items: type: object properties: surfaceKey: type: string surfaceName: type: string impact: anyOf: - enum: - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: How a report affects a surface. - type: 'null' required: - surfaceKey - surfaceName - impact required: - id - state - message - publishedAt - impacts description: Published updates, newest first. required: - id - kind - title - state - startedAt - resolvedAt - scheduledStartAt - scheduledEndAt - impacts - updates description: Open incidents and in-progress maintenance. upcomingMaintenance: type: array items: type: object properties: id: type: string format: uuid kind: enum: - incident - maintenance type: string title: type: string state: enum: - investigating - identified - monitoring - resolved - scheduled - in_progress - completed type: string description: >- Incidents move through investigating, identified, monitoring and resolved; maintenance through scheduled, in_progress and completed. startedAt: type: string format: date-time resolvedAt: anyOf: - type: string format: date-time - type: 'null' scheduledStartAt: anyOf: - type: string format: date-time - type: 'null' scheduledEndAt: anyOf: - type: string format: date-time - type: 'null' impacts: type: array items: type: object properties: surfaceKey: type: string surfaceName: type: string impact: anyOf: - enum: - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: How a report affects a surface. - type: 'null' required: - surfaceKey - surfaceName - impact description: >- What the latest published update says the report affects. updates: type: array items: type: object properties: id: type: string format: uuid state: enum: - investigating - identified - monitoring - resolved - scheduled - in_progress - completed type: string description: >- Incidents move through investigating, identified, monitoring and resolved; maintenance through scheduled, in_progress and completed. message: type: string publishedAt: type: string format: date-time impacts: type: array items: type: object properties: surfaceKey: type: string surfaceName: type: string impact: anyOf: - enum: - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: How a report affects a surface. - type: 'null' required: - surfaceKey - surfaceName - impact required: - id - state - message - publishedAt - impacts description: Published updates, newest first. required: - id - kind - title - state - startedAt - resolvedAt - scheduledStartAt - scheduledEndAt - impacts - updates recentReports: type: array items: type: object properties: id: type: string format: uuid kind: enum: - incident - maintenance type: string title: type: string state: enum: - investigating - identified - monitoring - resolved - scheduled - in_progress - completed type: string description: >- Incidents move through investigating, identified, monitoring and resolved; maintenance through scheduled, in_progress and completed. startedAt: type: string format: date-time resolvedAt: anyOf: - type: string format: date-time - type: 'null' scheduledStartAt: anyOf: - type: string format: date-time - type: 'null' scheduledEndAt: anyOf: - type: string format: date-time - type: 'null' impacts: type: array items: type: object properties: surfaceKey: type: string surfaceName: type: string impact: anyOf: - enum: - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: How a report affects a surface. - type: 'null' required: - surfaceKey - surfaceName - impact description: >- What the latest published update says the report affects. updates: type: array items: type: object properties: id: type: string format: uuid state: enum: - investigating - identified - monitoring - resolved - scheduled - in_progress - completed type: string description: >- Incidents move through investigating, identified, monitoring and resolved; maintenance through scheduled, in_progress and completed. message: type: string publishedAt: type: string format: date-time impacts: type: array items: type: object properties: surfaceKey: type: string surfaceName: type: string impact: anyOf: - enum: - degraded_performance - partial_outage - major_outage - under_maintenance type: string description: How a report affects a surface. - type: 'null' required: - surfaceKey - surfaceName - impact required: - id - state - message - publishedAt - impacts description: Published updates, newest first. required: - id - kind - title - state - startedAt - resolvedAt - scheduledStartAt - scheduledEndAt - impacts - updates description: The 20 most recently resolved reports. generatedAt: type: string format: date-time required: - page - status - sections - surfaces - activeReports - upcomingMaintenance - recentReports - generatedAt ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.