---
title: "Public outage reading for one tracked service (no API key)"
method: GET
path: "/outages/{slug}"
tags: ["Outages"]
---

# Public outage reading for one tracked service (no API key)

`GET /outages/{slug}`

## Request

- Base URL: `https://realuptime.io/api/v1`
- URL: `https://realuptime.io/api/v1/outages/{slug}`
- Auth: none required

## Path parameters

- `slug` string, required

## Query parameters

- `region` 'iad' | 'sjc' | 'fra' | 'nrt' | 'ord' | 'yyz' | 'lhr' | 'sin' | 'syd' | 'gru'

## Response `200`

The current reading, with schema_version and a citable source.url.

- object
  - `schema_version` number, required
  - `service` object, required
    - `slug` string, required
    - `name` string, required
    - `category` string, required
  - `verdict` string, required
  - `summary` string, required
  - `vendor` object, required
    - `feed_working` boolean, required
    - `statement` string
    - `label` string
    - `as_of` string
    - `status_page_url` string, nullable
    - `declares_outage` boolean
    - `incident` object, nullable
      - `id` string, required
      - `name` string, required
      - `impact` string, required
      - `status` string, required
      - `started_at` string, required
      - `latest_update` object, required
        - `text` string, nullable, required
        - `at` string, nullable, required
    - `other_live_incidents` number
    - `regional_reading` object
      - `label` string, required
      - `sentence` string, required
      - `note` string, required
      - `regions_checked` number, required
      - `regions_failing` string[], required
      - `regions_passing` string[], required
      - `regions_blocked` string[], required
  - `measured_at` string, nullable, required
  - `freshness` object, required
    - `verdict` string, required
    - `stale_after_seconds` number, required
    - `cadence_seconds` number, required
  - `regions_read` object[], required
    - `region` 'iad' | 'sjc' | 'fra' | 'nrt' | 'ord' | 'yyz' | 'lhr' | 'sin' | 'syd' | 'gru', required
    - `endpoint_role` string, required
    - `status` string, required
    - `status_code` number, nullable, required
    - `latency_ms` number, nullable, required
    - `measured_at` string, required
    - `fresh` boolean, required
  - `coverage` object, required
    - `regions_monitored` string[], required
    - `regions_not_monitored` string[], required
    - `measurement_depth` string, required
    - `first_observed_at` string, required
  - `recent_events` object, required
    - `available` boolean, required
    - `window_days` number
    - `limit` number
    - `tracking_since` string, nullable
    - `events` object[]
      - `id` string, required
      - `started_at` string, required
      - `ended_at` string, nullable, required
      - `open` boolean, required
      - `duration_ms` number, required
      - `duration_minutes` number, required
      - `peak_level` 'down' | 'partially_down', required
      - `regions` string[], required
      - `facets` string[], required
      - `scope` string, required
      - `detected_by` 'probe', required
  - `report_volume` object, required
    - `available` boolean, required
    - `total_reports` number, required
    - `total_reporters` number, required
  - `check_evidence` object, nullable
    - `kind` 'live_data' | 'api_route' | 'health_route' | 'auth_wall' | 'error_answer' | 'discovery_document' | 'public_page' | 'redirect_only' | 'bot_challenge', required
    - `checked_host` string, nullable, required
    - `shows` string, required
    - `does_not_show` string, required
  - `source` object, required
    - `url` string, required
    - `methodology_url` string, required
    - `publisher` string, required

## Other responses

- `400`: Malformed slug or region. - `RU-6002` Invalid outage query: https://realuptime.io/kb/errors/ru-6002
- `404`: Not a tracked service -- "not covered", never reported as healthy. - `RU-6001` Service not covered by the outage tracker: https://realuptime.io/kb/errors/ru-6001
- `429`: Per-IP keyless read budget exceeded. - `RU-6003` Public outage API rate limited: https://realuptime.io/kb/errors/ru-6003

---

[API](https://skmtc.dev/realuptime/apis/realuptime-api-v1.md) · [All operations](https://skmtc.dev/realuptime/apis/realuptime-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/realuptime/apis/realuptime-api-v1/revisions/51e481084700?raw)