Every US layoff. Real-time API.

Structured data from WARN filings, SEC 8-Ks, and verified press releases. Updated daily. One endpoint. Zero noise.

Live response preview

{
  "events": [
    {
      "id": "00631e5a-25a2-43b6-8f02-a1132e8bb1b0",
      "company_name": "Plug Power, Inc.",
      "worker_count": null,
      "state": "NY",
      "city": null,
      "sector": null,
      "source": "warn",
      "filing_date": null,
      "effective_at": null,
      "source_url": "https://dol.ny.gov/warn-notices",
      "created_at": "2026-04-11T01:12:26.57435+00:00"
    },
    {
      "id": "2adb0034-eca3-406e-afc3-557e0d1a4cc8",
      "company_name": "Interstate Hotels, LLC. dba The Roosevelt Hotel",
      "worker_count": null,
      "state": "NY",
      "city": null,
      "sector": null,
      "source": "warn",
      "filing_date": null,
      "effective_at": null,
      "source_url": "https://dol.ny.gov/warn-notices",
      "created_at": "2026-04-11T01:12:26.875804+00:00"
    },
    {
      "id": "20093158-3c9c-495e-b7b6-f4700dee4c1d",
      "company_name": "Macy’s Retail Holdings, Inc.",
      "worker_count": 192025,
      "state": "NY",
      "city": null,
      "sector": null,
      "source": "warn",
      "filing_date": null,
      "effective_at": null,
      "source_url": "https://dol.ny.gov/warn-notices",
      "created_at": "2026-04-11T01:12:31.798971+00:00"
    }
  ],
  "meta": {
    "total": 24,
    "limit": 50,
    "offset": 0,
    "tier": "free",
    "calls_remaining": 97
  }
}

Simple pricing

Free

$0/mo

100 API calls / month
All layoff event data
Filter by state, date, sector
JSON response format

Get started free

RECOMMENDED

Pro

$99/mo

Unlimited API calls
All layoff event data
Webhooks for new events (coming soon)
Priority support

Start Pro trial

Quick start

curl

curl -H "Authorization: Bearer lp_live_YOUR_KEY" \
  "https://recession.world/api/v1/events?since=2026-04-01&state=CA&limit=10"

Python

import requests

resp = requests.get(
    "https://recession.world/api/v1/events",
    headers={"Authorization": "Bearer lp_live_YOUR_KEY"},
    params={"since": "2026-04-01", "limit": 50},
)
events = resp.json()["events"]
print(f"Found {len(events)} layoff events")

Node.js

const res = await fetch(
  "https://recession.world/api/v1/events?since=2026-04-01",
  { headers: { Authorization: "Bearer lp_live_YOUR_KEY" } }
);
const { events, meta } = await res.json();
console.log(`${meta.total} events, ${meta.calls_remaining} calls left`);

Endpoint reference

Method	Endpoint	Description
`GET`	`/api/v1/events`	Fetch layoff events with filtering
`POST`	`/api/v1/keys`	Generate a free API key
`POST`	`/api/v1/billing/checkout`	Create Stripe checkout for Pro upgrade

Query parameters

Param	Type	Default	Description
`since`	ISO date	7 days ago	Filter events filed on or after this date
`state`	2-letter code	all	Filter by US state (e.g. CA, TX, NY)
`limit`	integer	50	Results per page (max 500)
`offset`	integer	0	Pagination offset

Authentication

Pass your API key in the Authorization header:

Authorization: Bearer lp_live_your_key_here

Response schema

{
  "events": [{
    "id": "uuid",
    "company_name": "string",
    "worker_count": "number | null",
    "state": "string | null",
    "city": "string | null",
    "sector": "string | null",
    "source": "warn | sec | press",
    "filing_date": "YYYY-MM-DD | null",
    "effective_at": "YYYY-MM-DD | null",
    "source_url": "string | null",
    "created_at": "ISO 8601"
  }],
  "meta": {
    "total": "number",
    "limit": "number",
    "offset": "number",
    "tier": "free | pro",
    "calls_remaining": "number (free tier only)"
  }
}

FAQ

What data do you provide?

Every WARN Act filing, SEC 8-K layoff disclosure, and verified press release for US workforce reductions. Each event includes company name, worker count, location, sector, filing date, and source URL.

How fresh is the data?

Events are ingested within hours of public filing. Our pipeline monitors state WARN databases, SEC EDGAR, and press wires continuously.

What sources do you use?

Official WARN Act filings from all 50 US states, SEC 8-K filings tagged with workforce reductions, and verified press releases from credible outlets.

What are the rate limits?

Free tier: 100 API calls per calendar month. Pro tier ($99/mo): unlimited calls. Monthly counters reset on the 1st.

Can I use the data commercially?

Yes. Both free and pro tiers allow commercial use. Attribution appreciated but not required.

Do you offer webhooks?

Webhooks for real-time event notifications are coming soon for Pro subscribers. Today you can poll the events endpoint.

Start building with layoff data

Free API key in 10 seconds. No credit card required.

Get your API key