WARN noticesState records30 states and DC, daily

Who is laying people off, how many, and when.

An employer with 100 or more staff has to give 60 days' notice of a mass layoff or a closure, under the WARN Act, and each state publishes the notices it gets in its own format. pdatum reads them every day and serves them in one shape. Each names the employer, the place, how many people and the dates, and links to the private companies lenders hold.

Request a key

More than 37,000 notices from 30 states and DC, each state read every day, and every notice kept once read.

Illustrative: Acme and its notice are invented.

What a script can ask

The questions the feed is built to answer, and the field that answers each.

Is a company we track cutting staff?

A notice links to a company when the employer's name, as the state wrote it, is that company's name. Case, punctuation, a legal form and a site in parentheses are ignored. Nothing else is, and a former name never links.

"matched": "Acme Fabrication" // from "(Plano)"

How many people, and from when?

workers is how many the notice says are affected. notice_at is when the employer gave notice, and effective_at when the layoff starts. Each is null when the state leaves it out, never a guess.

"workers": null // Missouri never says

What is new since I last looked?

/warn/changes returns every notice read for the first time since then, and every notice newly linked to a company or employer. Upsert by id and a copy stays in sync.

GET /warn/changes?since=1790000000

Is the state read at all?

/warn/states lists every state and DC and when we last read each. Asking about a state we do not read yet says so, never answers with a zero.

404 not_found // "We don't read OH ..."

What a record holds

One record per notice. The API reference has a whole example.

id, state
Our number for the notice, which is what to upsert by, and the state that published it.
employer, location
The employer and the place exactly as the state wrote them. A place can be a city, a county, or a list of counties.
kind
The state's own label, like layoff, closure or temporary. Many states give none, so it is often null.
workers
How many people the notice says are affected. Null when the state publishes no count.
notice_at, effective_at
When the employer gave notice, and when the layoff starts. Either is null when the state leaves it out.
company, matched
The company under Companies whose name the employer's name is, and the name that matched. Null for most notices.
employer_slug
The same, for the employers behind job postings.
source, observed_at
The state's page, and when we first read the notice. Every notice read is kept, even after the state takes it down.

Good to know

How the data behaves, in brief. The front page lists every source we read, and the API reference has the rest.

  • 30 states and DC, every dayEach state is read daily, and a notice is kept once read, even after the state takes it down. /warn/states lists every state, when it was last read and where its notices start.
  • Links are leadsA notice links to a company when the employer's name is the company's own. Notices often name a subsidiary or a single site, so confirm a link before you rely on it.
  • Dates as the state gives themNotice and layoff dates are the state's own. Where a state leaves one out, as New Jersey and Pennsylvania do with notice dates, it is null rather than a guess.

The other feeds

Jobs and employers

Open postings with their full text, the employers behind them, and a changes feed that keeps a copy in sync, with dates a backtest can trust.

GET/api/v1/jobs

Federal awards

The contracts and grants federal agencies have awarded any company you name, from USAspending.gov: how many, how much, from which agencies, and when the work ends.

GET/api/v1/awards

BDC books

Every loan a business development company reports each quarter, from its SEC filings, and how every other lender we read marks the same loan.

GET/api/v1/bdc/books/{ticker}

Companies

Every private company the BDCs we read hold, under every name their lenders file it as, with one slug. Any name can be looked up; one we do not hold is searched for on EDGAR.

GET/api/v1/companies/resolve

Franchise filings

Franchisors' registrations and exemption notices with the states, every Texas filing back to 1985, with their brands, dates and status, linked to the companies lenders hold.

GET/api/v1/franchises

Capital raises

Every private capital raise a company has reported to the SEC on Form D since 2008: how much it offered, how much it sold and to how many investors, linked to the companies lenders hold.

GET/api/v1/raises

Ask for a key

Keys are issued by hand while the API is young. Write to pdatum@pearachute.com and say what you are building and which data you need. If you need a state we do not read yet, say which: requests decide which comes next.