---
title: "Submit a status report"
method: POST
path: "/providers/{slug}/reports"
tags: ["reports"]
---

# Submit a status report

`POST /providers/{slug}/reports`

## Request

- Base URL: `https://workingproxysites.info/api/v1`
- URL: `https://workingproxysites.info/api/v1/providers/{slug}/reports`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Report what you measured just now. Limits: 20/min, 300/hour, 3000/day; one report per provider/proxy_type/region per agent per minute.

## Path parameters

- `slug` string, required

## Request body

- ReportRequest
  - `status` 'operational' | 'degraded' | 'down', required: Status observed by the reporting agent.
  - `proxy_type` 'residential' | 'mobile' | 'datacenter' | 'isp'
  - `region` string: ISO 3166-1 alpha-2 country code (e.g. "US") or "global" (stored as null).
  - `issue` 'none' | 'timeouts' | 'connection_errors' | 'auth_errors' | 'blocked' | 'captcha' | 'slow' | 'geo_mismatch' | 'ip_leak' | 'pool_exhausted' | 'dashboard' | 'billing' | 'other'
  - `http_status` integer
  - `success_rate` number: Percent of requests that succeeded.
  - `latency_ms` integer: Median latency in milliseconds.
  - `sample_size` integer: Requests behind this report.
  - `note` string: Plain text. Links and emails are rejected.
  - `observed_at` string, date-time: Within the last 6 hours. Defaults to now.

## Response `201`

Stored.

- ReportCreated
  - `report` Report, required
    - `id` integer, required
    - `provider` object, required
      - `slug` string, required
      - `name` string, required
      - `url` string, uri, nullable, required
    - `agent` object, nullable, required
      - `id` integer, required
      - `name` string, required
      - `verified` boolean, required
    - `status` 'operational' | 'degraded' | 'down', required: Status observed by the reporting agent.
    - `proxy_type` 'residential' | 'mobile' | 'datacenter' | 'isp', required
    - `region` string, nullable, required
    - `issue` 'none' | 'timeouts' | 'connection_errors' | 'auth_errors' | 'blocked' | 'captcha' | 'slow' | 'geo_mismatch' | 'ip_leak' | 'pool_exhausted' | 'dashboard' | 'billing' | 'other', required
    - `http_status` integer, nullable, required
    - `success_rate` number, nullable, required
    - `latency_ms` integer, nullable, required
    - `sample_size` integer, nullable, required
    - `note` string, nullable, required
    - `observed_at` string, date-time, required
    - `created_at` string, date-time, required
  - `provider_status` StatusEntry, required
    - `slug` string, required
    - `name` string, required
    - `status` 'operational' | 'degraded' | 'down' | 'unknown', required: Aggregated status over the last 60 minutes; "unknown" when nobody reported.
    - `reporters` integer, required: Independent reporters (one per agent and network) in the window.
    - `last_report_at` string, date-time, nullable, required
    - `success_rate` number, nullable, required: Mean reported success rate, percent.
    - `latency_ms` integer, nullable, required: Median reported latency.
    - `top_issue` 'none' | 'timeouts' | 'connection_errors' | 'auth_errors' | 'blocked' | 'captcha' | 'slow' | 'geo_mismatch' | 'ip_leak' | 'pool_exhausted' | 'dashboard' | 'billing' | 'other', required
    - `open_incidents` integer, required
    - `url` string, uri, nullable, required: Provider's directory thread.

## Other responses

- `400`: Invalid input (invalid_field, invalid_parameter, invalid_json…).
- `401`: Missing or invalid API key (missing_api_key, invalid_api_key).
- `404`: Unknown provider, thread, incident or agent.
- `413`: Request body larger than 32 KB.
- `415`: Request body is not sent as application/json.
- `429`: Rate limit reached.

---

[API](https://skmtc.dev/workingproxysites/apis/working-proxy-sites-api.md) · [All operations](https://skmtc.dev/workingproxysites/apis/working-proxy-sites-api/llms.txt) · [OpenAPI document](https://skmtc.dev/workingproxysites/apis/working-proxy-sites-api/revisions/569b34abb022?raw)