# WARN Firehose
> Six unified labor market datasets: WARN layoffs, H-1B/LCA visas, unemployment claims, SEC 8-K filings, bankruptcy cases, and JOLTS labor turnover.

## What is this?
WARN Firehose aggregates six datasets into a single, searchable labor market intelligence platform:
1. **WARN Act Notices** — 93K+ mass layoff notices from all 50 US states
2. **H-1B & LCA Petitions** — 5.9M visa petitions (DOL LCA + USCIS H-1B)
3. **Unemployment Claims** — 42 years of DOL weekly initial/continued claims
4. **SEC 8-K Filings** — Material event disclosures for public companies
5. **Bankruptcy Filings** — Chapter 11 cases cross-referenced with WARN notices
6. **JOLTS Data** — BLS job openings, hires, quits, layoffs/discharges
Data is updated daily at 5 AM UTC.

## API Base URL
https://warnfirehose.com/api

## WARN Endpoints
- GET /api/records — Query layoff notices (state, company, date_from, date_to, limit, offset)
- GET /api/stats — Database statistics
- GET /api/states — Per-state summary
- GET /api/trends — Monthly trend data (supports city filter)
- GET /api/top-companies — Companies with most notices
- GET /api/search?q= — Full-text search
- GET /api/counties?state= — County-level data
- GET /api/cities?state= — City-level data
- GET /api/industries — Industry breakdown (NAICS)
- GET /api/company/{name} — Company detail
- GET /api/unified-search?q= — Search across all 6 datasets

## H-1B & LCA Endpoints
- GET /api/lca/stats — LCA petition statistics (state, fiscal_year, visa_class)
- GET /api/lca/by-state — Petitions by state
- GET /api/lca/by-city — Petitions by city
- GET /api/lca/by-soc — Petitions by occupation (SOC code)
- GET /api/lca/employers — Top employers
- GET /api/lca/wages — Wage data
- GET /api/h1b/stats — H-1B petition statistics
- GET /api/h1b/employers — Top H-1B employers
- GET /api/h1b/by-state — H-1B by state

## Unemployment Claims Endpoints
- GET /api/dol-claims — Weekly claims (state, start, end)
- GET /api/dol-claims/national — National weekly totals
- GET /api/dol-claims/stats — Summary statistics

## SEC 8-K Endpoints
- GET /api/sec-filings — Query filings (ticker, company, items, date range)
- GET /api/sec-filings/stats — Filing statistics
- GET /api/sec-filings/ticker/{ticker} — Filings for a ticker
- GET /api/sec-filings/warn-crossref — Cross-reference with WARN

## Bankruptcy Endpoints
- GET /api/bankruptcies — Query filings (company, chapter, court)
- GET /api/bankruptcies/stats — Filing statistics
- GET /api/bankruptcies/warn-crossref — Cross-reference with WARN

## JOLTS Endpoints
- GET /api/jolts/stats — Summary statistics
- GET /api/jolts/national — National data (element: JO/HI/TS/QU/LD)
- GET /api/jolts/by-state — State-level data
- GET /api/jolts/by-industry — Industry breakdown
- GET /api/jolts/trends — Monthly trends

## Cross-Reference Endpoints
- GET /api/market-pulse — Single-call market snapshot: all 6 datasets, top industries, at-risk companies, trend direction
- GET /api/state-intelligence/{state_code} — Unified state profile: WARN + LCA + H-1B + DOL + bankruptcy + JOLTS with distress score
- GET /api/risk-signal — Companies ranked by composite distress score (state, min_score, limit)
- GET /api/risk-signal/company/{name} — Company intelligence: risk score + LCA roles + SEC + bankruptcy + H-1B
- GET /api/crossref/layoffs-vs-h1b — WARN layoffs vs H-1B hiring
- GET /api/crossref/company-timeline/{company} — Full company timeline
- GET /api/crossref/talent-pipeline — Laid-off workers by occupation/skill (state, soc_code, days)
- GET /api/crossref/by-state — Cross-dataset state comparison
- GET /api/crossref/by-company — Cross-dataset company comparison

## Authentication
- Free tier: no API key needed, 25 calls/day, 25 records/call, 90-day history
- Paid tiers: X-API-Key header, higher limits, exports, full history
- Get a free key: POST /api/keys with {"email": "you@example.com"}

## Export Formats (paid tiers)
- GET /api/export/csv
- GET /api/export/json (NDJSON)
- GET /api/export/parquet
- GET /api/export/jsonld (schema.org)

## New: H-1B Risk Check & Violations
- GET /api/h1b-risk-check?employer= — H-1B employer risk assessment (WARN + LCA + H-1B cross-reference)
- GET /api/violations — Potential WARN Act violations (companies with <60 day notice gap)
- GET /api/watchlist — Server-side company watchlist for subscribers

## MCP Server (Model Context Protocol)
WARN Firehose provides an MCP server for direct AI tool integration.
- HTTP endpoint: https://warnfirehose.com/mcp
- Discovery manifest: https://warnfirehose.com/.well-known/mcp.json
- Free tools: search_layoffs, get_state_summary, get_recent_layoffs, get_stats, get_company_layoffs, get_market_pulse
- Starter+ tools: get_risk_signal, get_talent_pipeline (requires API key)
- Pro+ tools: get_state_intelligence, export_records (requires Pro API key)
- Authentication: Pass API key via authenticate() tool or Authorization header

## Layoff Pages (SEO / Browse)
Pre-rendered pages with state, city, industry, and company layoff data:
- /data/layoffs — Hub page: browse all states, industries, top companies
- /data/layoffs/{state-slug} — State layoff page (e.g. /data/layoffs/california, /data/layoffs/texas)
- /data/layoffs/{state-slug}/{city-slug} — City layoff page (e.g. /data/layoffs/texas/dallas)
- /data/layoffs/industry/{slug} — Industry page (e.g. /data/layoffs/industry/technology, /data/layoffs/industry/healthcare)
- /data/layoffs/company/{slug} — Company page (e.g. /data/layoffs/company/amazon, /data/layoffs/company/meta)
Each page includes: recent WARN notices table, summary stats, FAQ, structured data (JSON-LD).
All pages are static HTML, updated daily. Over 270 pages covering 51 states, 100 cities, 18 industries, 100+ companies.

## Blog / Analysis
WARN Firehose publishes monthly and weekly analysis of WARN Act layoff data.
- /blog — Index of all reports
- /blog/{year}/{month} — National monthly summary (e.g. /blog/2026/01)
- /blog/{year}/{month}/{state-slug} — State monthly report (e.g. /blog/2026/01/california)
- /blog/{year}/{month}/week-{n} — National weekly summary, 2026+ (e.g. /blog/2026/01/week-1)
- /blog/{year}/{month}/week-{n}/{state-slug} — State weekly report, 2026+
Content includes: layoff counts, workers affected, industry breakdowns, geographic hotspots,
trend charts, largest layoffs, and forward-looking analysis. Updated daily.

## OpenAPI Spec
Full OpenAPI 3.x spec: https://warnfirehose.com/openapi.json

## More Information
For complete API documentation: https://warnfirehose.com/llms-full.txt