Skip to main content

Data API docs · H-1B sponsorship

H-1B sponsorship profile from certified LCA wage filings

GET https://usefootnote.com/api/data/v1/h1b/employer

200: { data, meta }. Free tier: sponsors yes/no + certified filing volume. Pro/enterprise: fiscal-year trend, wage-level mix, filing entities, and — where the sample clears the quality bar — role-level pay bands. 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.

TierCallsBurstWARN window
Free50/day10/min30 days
Developer1,000/day30/min12 months
Data Pro10,000/day120/min24 months
Enterprise100,000/day600/minfull archive

Parameters

NameTypeRequiredDescription
namestringyesCompany name, min 3 chars. Normalized prefix match on certified LCA filings — under-matches rather than misattributes.

Example

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

200Sponsorship profile. Wage figures are BASE-SALARY attestations — floors, not total comp. 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.

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.