Data API docs · H-2, PERM and OPT programs
H-2A/H-2B seasonal-labor certifications for an employer (Data Pro)
GET https://usefootnote.com/api/data/v1/h2/employers
Per-employer OFLC H-2A/H-2B certification detail, grouped by program × fiscal year: applications decided vs certified, workers requested vs certified (WORKERS on the application — OFLC intent, not visas issued), RAW wage bands read with their wage_unit (NEVER annualized — seasonal work), and worksite states. Exact-normalized-name matching. DATA PRO dataset: a free key receives 403 upgrade_required (never a silent 404 — /datasets shows the holding exists). Errors: 400 · 401 · 403 upgrade_required (free key) or key suspended · 429 · 5xx typed { error }.
Tier
Data Pro and above. Free and Developer keys receive a 403 upgrade_required that names this dataset and the way up — never a silent 404.
| 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 name, min 2 chars. Exact-normalized-name match plus registered spelling variants. |
| program | string | no | Restrict to one program. |
| fy | integer | no | 4-digit fiscal-year filter. |
Example
curl -s "https://usefootnote.com/api/data/v1/h2/employers?name=Acme%20Corp" \ -H "Authorization: Bearer fn_live_YOUR_KEY"
200 — Groups per program × fiscal year. Wage bands are RAW rates with their unit; worker counts are OFLC application workers, never visas issued. 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 H-2, PERM and OPT programs
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.