Data API · reference
Every endpoint, documented from the contract.
One page per endpoint — parameters, the tier it needs, rate limits, an example call — generated from the same OpenAPI document the routes are tested against, so the docs cannot drift from the API.
Base URL https://usefootnote.com · bearer key from your account · machine-readable spec at /api/data/v1/openapi.json.
Tiers and limits
| Tier | Price | Calls | Burst | WARN window |
|---|---|---|---|---|
| Free | $0 | 50/day | 10/min | 30 days |
| Developer | $29/mo | 1,000/day | 30/min | 12 months |
| Data Pro | $79/mo · $790/yr | 10,000/day | 120/min | 24 months |
| Enterprise | from $299/mo | 100,000/day | 600/min | full archive |
The H-2, PERM and OPT series and CSV export are Data Pro and above. Plans and licensing on /data.
WARN layoff notices
- Recent WARN layoff notices (rolling window)GET /warn/recent
- Search WARN notices (employer, state, date window, pagination)GET /warn/notices
- Per-state WARN coverage and notice countsGET /warn/states
- CSV export of the WARN window your tier can seeGET /warn/export.csv
- Historical WARN archive CSV (licensed export)GET /warn/historical.csv
H-1B sponsorship
- H-1B sponsorship profile from certified LCA wage filingsGET /h1b/employer
- Top sponsoring employers by certified filing volumeGET /h1b/top-sponsors
- Employers with certified LCA employment windows covering today, by covered worker positionsGET /h1b/active-sponsors
- Sponsorship posture from federal petition OUTCOMES (approvals/denials per fiscal year)GET /sponsorship/employer
H-2, PERM and OPT programs
- H-2A/H-2B seasonal-labor certifications for an employer (Data Pro)GET /h2/employers · Data Pro
- National H-2A/H-2B KPIs + USCIS approved-worker trend (Data Pro)GET /h2/summary · Data Pro
- PERM green-card certification decision counts for an employer (Data Pro)GET /perm/employers · Data Pro
- ICE SEVP Top-200 OPT / STEM-OPT employers, ranked (Data Pro)GET /opt/top-employers · Data Pro
Employer posture — wages, severance, litigation, enforcement, safety, debarment
- Advertised posting ranges vs the attested LCA band, per roleGET /wage-comparison/employer
- Executive severance terms extracted from public filingsGET /severance/employer
- Employment-relevant litigation posture from public court recordsGET /litigation/employer
- Wage-enforcement history (WHD case outcomes)GET /enforcement/employer
- Workplace-safety posture (OSHA inspections + citations)GET /osha/employer
- DOL debarment status for an employer (current / lapsed / none)GET /debarment
Datasets and the contract
Prefer a client? The footnote-data CLI wraps every endpoint, and the remote MCP server at /api/mcp exposes them as tools. Data is CC BY 4.0 for display with attribution; commercial licensing is on Data Pro and above.