DEVELOPERS

CanaryWhistle API

A clean JSON feed of every US WARN Act layoff and closure filing, enriched with role families, comp and payroll estimates. Query the live feed, the forward calendar, the trend index and any company's history. Built for investors, sales-intelligence, credit-risk and commercial-real-estate teams. Get a key on the Data / API plan.

Base URL & auth

All endpoints live under https://canarywhistle.com/api/v1. Authenticate with your key as a Bearer token on every request.

curl https://canarywhistle.com/api/v1/filings?state=CA&min=250 \
  -H "Authorization: Bearer cw_live_your_key_here"

Endpoints

GET /api/v1/filings

Paginated, filterable list of WARN filings (newest first). Each record includes role families, median comp and est. payroll released.

state — 2-letter state, e.g. CA
metro — metro slug, e.g. bay-area, dallas, nyc
industry — industry slug, e.g. technology
role — role family, e.g. Engineering
min — minimum headcount, e.g. 100
type — Layoff or Closure
q — free text: company or city
since_days — only filings logged in the last N days
page / limit — pagination (limit max 200)

GET /api/v1/upcoming

Forward calendar: jobs scheduled to be cut, from filed effective dates. Same filters, plus days (horizon, max 365).

GET /api/v1/trends

Monthly filing volume and 90-day industry/state momentum (the CanaryWhistle Index).

GET /api/v1/companies/:slug

Every filing on record for one employer, with totals and affected states.

Example response

{
  "object": "list",
  "data": [
    {
      "id": "cmq...",
      "company": "Meta Platforms, Inc.",
      "city": "Menlo Park",
      "state": "CA",
      "employees": 2212,
      "industry": "Technology",
      "roles": ["Engineering", "Sales", "Marketing"],
      "median_comp_usd": 122000,
      "payroll_released_usd": 269864000,
      "type": "Layoff",
      "notice_date": "2026-05-22T00:00:00.000Z",
      "effective_date": "2026-07-22T00:00:00.000Z",
      "source_url": "https://edd.ca.gov/...",
      "url": "https://canarywhistle.com/drop/cmq..."
    }
  ],
  "page": 1, "limit": 50, "total": 38, "has_more": false
}

Data sourced from public state WARN Act registries. Fair-use limits apply. Need higher volume or a bulk feed? Reply to your receipt email.