---
title: "Submit an outage report"
method: POST
path: "/reports"
tags: ["Reports"]
---

# Submit an outage report

`POST /reports`

Submit a new community outage report. No reCAPTCHA required when using an API key.

## Request body

- CreateReportInput
  - `zipCode` string, required — 5-digit US ZIP code
  - `serviceType` 'internet' | 'tv' | 'phone' | 'all', required
  - `startedWhen` 'just_now' | 'last_hour' | 'few_hours' | 'today' | 'yesterday' | 'days_ago', required
  - `note` string — Optional short note

## Response `201`

Report created

- ReportResponse
  - `data` 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)