Data API docs · Employer posture — wages, severance, litigation, enforcement, safety, debarment
DOL debarment status for an employer (current / lapsed / none)
GET https://usefootnote.com/api/data/v1/debarment
Is this employer on a U.S. DOL debarred/disqualified list right now? FREE tier: matched + status (current | lapsed | none) + the debarring program labels. Pro: the full history rows — dates, DOL entity spelling, willful-violator flag, and violation text. `status` is DERIVED at read time (permanent, or debarred_until >= today UTC), never stored. Matching is EXACT normalized legal name + registered spelling variants, never fuzzy — so a no-match means no exact-name entry on the list, NOT that the employer is in good standing. 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 |
|---|---|---|---|
| employer | string | yes | Employer legal name (min 2 chars). Exact-normalized-name match plus registered spelling variants. |
Example
curl -s "https://usefootnote.com/api/data/v1/debarment?employer=Acme%20Corp" \ -H "Authorization: Bearer fn_live_YOUR_KEY"
200 — { data: { employer_query, matched, status, programs, history? }, meta }. history is Pro-only; is_current is derived, never stored. 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, 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.