Skip to main content

Getting Started

Go from zero to querying US layoff data in under 5 minutes.

1
Browse the data — no account needed

Start exploring six labor market datasets right away:

  • WARN Notices — 84,000+ layoff records, searchable by company, state, date, and industry
  • H-1B & LCA Visas — 5M+ visa petitions with drill-down by state, city, employer, and occupation
  • SEC 8-K Filings — material events from public companies, cross-referenced with layoffs
  • Bankruptcy Filings — Chapter 11 cases matched against WARN companies
  • JOLTS Labor Turnover — BLS hires, quits, and layoffs by state and industry
  • Charts — interactive visualizations across all datasets
  • Intelligence — Top layoff activity rankings, weekly reports, and AI analysis

All of this is free and public. Bookmark what's useful, then come back for API access when you're ready to build.

2
Get your free API key

Sign up to get instant API access:

  1. Go to /account
  2. Enter your email address
  3. Check your inbox for your API key

That's it. Your free key gives you 25 API calls per day, access to WARN data from the last 90 days, and JSON responses.

Need more? Paid plans unlock all datasets, historical data, bulk exports, and webhooks:

Free
$0
25 calls/day
WARN only, 90 days
Starter
$49/mo
200 calls/day
3 datasets, 1 year
Enterprise
Custom
Contact us
SLA + priority support

See full plan comparison →

3
Make your first API call

All API requests go to https://warnfirehose.com/api/ with your key in the X-API-Key header.

Get recent layoff notices

# Fetch the latest 10 layoff notices curl -H "X-API-Key: YOUR_KEY" \ "https://warnfirehose.com/api/records?limit=10"

Filter by state and date

# California notices from 2026 curl -H "X-API-Key: YOUR_KEY" \ "https://warnfirehose.com/api/records?state=CA&date_from=2026-01-01"

Search by company

# All Amazon layoff notices curl -H "X-API-Key: YOUR_KEY" \ "https://warnfirehose.com/api/records?company=Amazon"

Get aggregate stats

# National summary statistics (no API key needed) curl "https://warnfirehose.com/api/stats" # Monthly trend data curl "https://warnfirehose.com/api/trends?months=12" # Top companies by workers affected curl "https://warnfirehose.com/api/top-companies?limit=10"

Python example

import httpx resp = httpx.get( "https://warnfirehose.com/api/records", params={"state": "TX", "limit": "5"}, headers={"X-API-Key": "YOUR_KEY"}, ) for r in resp.json()["data"]: print(f"{r['company']} — {r['city']}, {r['state']} — {r['employees_affected']} workers")

JavaScript example

const resp = await fetch( "https://warnfirehose.com/api/records?state=NY&limit=5", { headers: { "X-API-Key": "YOUR_KEY" } } ); const { data } = await resp.json(); data.forEach(r => console.log(`${r.company} — ${r.employees_affected} workers`) );

Cross-dataset intelligence

# Full market snapshot — all 6 datasets in one call curl -H "X-API-Key: YOUR_KEY" \ "https://warnfirehose.com/api/market-pulse" # Get companies ranked by composite distress signal curl -H "X-API-Key: YOUR_KEY" \ "https://warnfirehose.com/api/risk-signal?min_score=4&limit=20" # Full timeline: WARN + SEC + bankruptcy events for one company curl -H "X-API-Key: YOUR_KEY" \ "https://warnfirehose.com/api/crossref/company-timeline/WeWork" # Unified state intelligence — all 6 datasets for one state curl "https://warnfirehose.com/api/state-intelligence/CA" # Company intelligence with LCA roles and risk factors curl "https://warnfirehose.com/api/risk-signal/company/Amazon" # Search across all 6 datasets at once curl -H "X-API-Key: YOUR_KEY" \ "https://warnfirehose.com/api/unified-search?q=Amazon"

Other datasets

# H-1B visa data: top employers curl -H "X-API-Key: YOUR_KEY" \ "https://warnfirehose.com/api/h1b/employers?limit=10" # SEC 8-K filings for a stock ticker curl -H "X-API-Key: YOUR_KEY" \ "https://warnfirehose.com/api/sec-filings/ticker/AAPL" # Bankruptcy filings matched to WARN companies curl -H "X-API-Key: YOUR_KEY" \ "https://warnfirehose.com/api/bankruptcies?warn_only=true"

See the full API documentation for all 100+ endpoints, parameters, and response formats.

4
Set up alerts and exports

Email digests

Get layoff data delivered to your inbox. Choose from:

  • Weekly blog digest — summary of new filings and trends each week
  • State alerts — notifications when new WARN notices are filed in your states

Subscribe at the bottom of any blog page or from your account page.

Webhooks (Pro and above)

Get real-time HTTP notifications when new filings match your criteria. Configure webhooks from your account page to push data to Slack, your app, or any HTTP endpoint.

Bulk exports

Download data in the format that fits your workflow:

  • CSV — for spreadsheets and quick analysis
  • JSON / NDJSON — for apps and scripts
  • Parquet — for data pipelines and warehouses (Pro+)
  • JSON-LD — for linked data and semantic web applications

Use the /api/export/{format} endpoint or download directly from the dashboard.

What's next?

Ready to go?

Get your free API key and start querying 84,000+ layoff notices from all 50 states.

Get Free API Key Browse Data

Stay Updated on Layoff Trends

Get daily WARN Act layoff data delivered to your inbox. Free.