Skip to main content
The Vol Radar API uses standard HTTP status codes. Error bodies are JSON with a detail field.

Status codes

Paging

/v1/signals pages with limit (1–1,000, default 100) and offset. The response gives count, the number of matching signals, so you can page until offset + limit >= count. Signals are sorted by first day (newest first), then tier, then score.

Defaults worth knowing

  • /v1/signals without date, from or changed_since returns signals first detected in the 30 days to the last day of data.
  • /v1/signals?date=… without status returns the active signals (new, escalated or ongoing).
  • /v1/snapshot on a date with no data (a weekend, a holiday) returns the latest earlier day; date in the response says which.
  • /v1/series defaults to the 30D bucket.

Versions and the closed beta

  • Paths start with /v1. /v1/status reports api_version.
  • During the closed beta, fields may still be added or renamed. Breaking changes are announced to beta users first.
  • A signal’s published evidence and earlier-case outcomes never change; see Keep a local copy up to date for the cases where a signal is updated or withdrawn.
Last modified on November 3, 2026