---
title: "Check ZIP code status"
method: GET
path: "/zip/{zip}"
tags: ["Locations"]
---

# Check ZIP code status

`GET /zip/{zip}`

Returns outage status and recent reports for a 5-digit US ZIP code.

## Path parameters

- `zip` string, required

## Response `200`

ZIP status

- ZipResponse
  - `data` ZipStatus
    - `zipCode` string
    - `status` 'issues_reported' | 'all_clear'
    - `reports` OutageReport[]
      - `id` integer
      - `zipCode` string
      - `serviceType` 'internet' | 'tv' | 'phone' | 'all'
      - `startedWhen` 'just_now' | 'last_hour' | 'few_hours' | 'today' | 'yesterday' | 'days_ago'
      - `note` string, nullable
      - `createdAt` string, date-time

## Other responses

- `400` — Invalid request body or parameters
- `401` — Missing Authorization header
- `403` — Invalid API key
- `429` — Rate limit exceeded (100 req/min)
- `500` — Server error

---

[API](https://skmtc.dev/spectrumoutage/apis/spectrumoutage-api.md) · [All operations](https://skmtc.dev/spectrumoutage/apis/spectrumoutage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spectrumoutage/spectrumoutage-api/revisions/d07b09c81945/schema)