Data API docs · Employer posture — wages, layoffs vs PERM, severance, litigation, enforcement, safety, debarment

WARN layoff notices beside certified PERM applications received in the same window (cross-signal)

GET https://usefootnote.com/api/data/v1/warn-perm/employer

200: { data, meta }. Free tier: signal (or null when thin) with the window, WARN notice count and certified PERM count. Pro/enterprise: adds PERM layoff attestations (Form ETA-9089 Section G), the published-worker floor, states and dated WARN receipts with source links. Errors: 400 bad params · 401 missing/invalid key · 403 key suspended · 429 burst or daily cap (retry-after header) · 5xx typed { error: { code, message } }.

Tier

Every tier. Free keys see the free window; Developer, Data Pro and Enterprise widen it — the exact figures below.

Tier	Calls	Burst	WARN window
Free	50/day	10/min	30 days
Developer	1,000/day	30/min	12 months
Data Pro	10,000/day	120/min	24 months
Enterprise	100,000/day	600/min	full archive

Parameters

Name	Type	Required	Description
name	string	yes	Employer legal name (2–160 chars). Matching is exact-normalized-name plus registered aliases (including known corporate renames) — never fuzzy: Footnote under-matches rather than misattributes.

Example

curl -s "https://usefootnote.com/api/data/v1/warn-perm/employer?name=Acme%20Corp" \
  -H "Authorization: Bearer fn_live_YOUR_KEY"

200 — Two records side by side, never a causal claim: meta.caveat travels on every tier. The PERM layoff question is scoped to one occupation and area — not evidence of a company-wide layoff. signal is null (with suppressed_reason) when either side is thin; a failed lookup is a 500, never a null. Every response is { data, meta }; rate-limit headers (x-ratelimit-limit, x-ratelimit-remaining) ride on every call.

Clients

npx footnote-data wraps this endpoint at the prompt (see the package README); the remote MCP server at https://usefootnote.com/api/mcp exposes it as a tool for agents. Licensing: CC BY 4.0 for display with attribution; commercial use on Data Pro and above.

Also in Employer posture — wages, layoffs vs PERM, severance, litigation, enforcement, safety, debarment

Need more depth than the free window? Developer is $29/mo, Data Pro $79/mo or $790/yr — plans on /data. Get a free key from your account.