XH1B API: H-1B Filings & Employer Records
Search H-1B labor condition applications and linked employer, wage, layoff, and public contract records. Coverage varies by source and year. Filing wage offers are not payroll observations; worker requests are not confirmed hires.
Public read endpoint index
GET /api/graph/evidence: Supporting source records for an entity relationship, paginatedGET /api/metrics-catalog: Source entity names and research ranking signals, with keyset paginationGET /api/metrics-evidence: Bounded employer research packet with explicit section populations and coverageGET /api/metrics-entity-evidence: Bounded source associations for a filing person or firmGET /api/search-mark/v1/[kind]/[code]: Census atlas state or county outline for search resultsGET /api/pw-record-context: Related wage determinations and employment filings for a prevailing wage recordGET /api/leaderboard: Ranked employers, employer contacts, and law firms from DOL recordsGET /api/evidence: WARN notices with nearby H-1B requests, position counts, and job titlesGET /api/search: Full-text + ILIKE searchGET /api/search-catalog: Public navigation search catalog packaged with the website buildGET /api/stats: National statsGET /api/employer-lcas: Employer LCA filings (sortable)GET /api/employer-attorneys: Employer's attorneysGET /api/employer-worksites: Employer's worksite locationsGET /api/employer-exec-comp: Employer's executive compensation (SEC DEF 14A), paginatedGET /api/comp-execs: All ranked executive compensation (SEC DEF 14A) at H-1B employers, paginated + sortableGET /api/employer-insider-signals: Employer's insider timing signals, paginatedGET /api/employer-insider-txns: Employer's insider sale transactions, paginatedGET /api/employer-persons: Employer's key peopleGET /api/person-lcas: Person's LCA filings (sortable)GET /api/firm-lcas: Firm LCA records; select full history for filtersGET /api/firm-cases: Court cases and shared clients for a matched law firm. kind selects direct, client, or shared evidence.GET /api/firm-clients: Firm clients or paired client wage comparisonsGET /api/firm-options: Search occupations in a firm's filing historyGET /api/firm-peers: Compare paired wages within one occupation and decision yearGET /api/firm-activity: Firm occupations, annual outcomes, or worksite statesGET /api/county-lcas: County LCA filings (sortable)GET /api/county-employers: County employers with BLS gapGET /api/county-soc: County SOC wage gaps (sorted by theft)GET /api/zip-lcas: ZIP LCA filings (sortable)GET /api/zip-employers: ZIP employersGET /api/zip-soc: ZIP SOC breakdownGET /api/soc-employers: Employers for SOC codeGET /api/soc-filings: SOC code filings, certified H-1B (sortable, below-prevailing facet)GET /api/soc-wage-trend: SOC yearly median offered wage vs BLS median (complete series)GET /api/search-catalog/[part]: Saved search names by set: states, counties, companies, people, firms, townsGET /api/lcas: National H-1B filings browser, filtered by decision year (sortable)GET /api/perm: National PERM labor-certification browser, filtered by decision year (sortable)GET /api/pw: National prevailing-wage determination browser, filtered by determination year (sortable)GET /api/h2a: National H-2A agricultural browser, filtered by employment begin year (sortable)GET /api/h2b: National H-2B seasonal browser, filtered by employment begin year (sortable)GET /api/cw1: National CW-1 Northern Marianas browser, filtered by employment begin year (sortable)GET /api/state-lcas: State LCA filings (sortable)GET /api/vertical-state-lcas: Vertical (medical/education/tech/finance) state LCA filings from a precomputed window (sortable)GET /api/state-warns: State WARN notices (sortable)GET /api/state-soc: State SOC wage gaps (sorted by theft)GET /api/state-lawfirms: State law firms with BLS gapGET /api/state-procurement: Largest 25 state source records, paginated. CT records expose payments, including grants, separately from contract awards.GET /api/state-contracts: State federal contractsGET /api/county-warns: County WARN noticesGET /api/record-revisions: Agency revision history for one tracked record (table + recordKey, paginated; page size fixed at the shared table default)GET /api/enforcement/leaderboard: Sortable employer leaderboard (caught/missed modes)GET /api/employer-perm: Employer PERM labor-cert filingsGET /api/employer-pw: Employer prevailing-wage determinationsGET /api/employer-contracts: Employer federal contractsGET /api/employer-state-contracts: Employer state-procurement contracts, paginatedGET /api/employer-displacement-events: Employer WARN↔LCA displacement-signal matches, paginatedGET /api/employer-officers: Employer directors / officers / beneficial ownersGET /api/employer-board: SEC proxy board slates and changes between stored yearsGET /api/employer-h2a: Employer H-2A agricultural filingsGET /api/employer-h2b: Employer H-2B seasonal filingsGET /api/employer-cw1: Employer CW-1 Northern Marianas filingsGET /api/scoped-specialties: SOC/specialty breakdown scoped to state/county/employer (sortable: volume|wage|suppression)GET /api/scoped-institutions: IPEDS institutions scoped to state/county (sortable: suppression|volume, or sortBy=institution_name|h1b_count|h1b_median_wage|pct_of_bls|pct_of_ipeds_all + sortDir)GET /api/scoped-hospitals: Hospital wage-gap breakdown scoped to state/countyGET /api/scoped-counties: County-level H-1B activity scoped to a state (medical or education vertical)GET /api/hospital-wage-gap: Hospital wage-suppression leaderboard (attending or residency mode)GET /api/education-wage-gap: Education faculty wage-suppression leaderboard (suppression or volume sort)GET /api/hospital-specialties: Hospital H-1B filings by clinical SOC (sortable)GET /api/hospital-intermediaries: Staffing agencies / sister facilities placing H-1B workers at a hospital (sortable)GET /api/university-specialties: University H-1B filings by SOC (sortable)GET /api/state-top-employers: State top employers by H-1B volumeGET /api/zip-warns: ZIP WARN noticesGET /api/employer-warns: Employer WARN (mass-layoff) notices (paginated)GET /api/export-employer: Public CSV export of an employer's source data (dataset: lcas | warns | contracts; CC-BY 4.0, capped at 10,000 rows)GET /api/employer-court-cases: Employer federal lawsuits (CourtListener / RECAP)GET /api/court-cases: Federal lawsuits naming matched employers, newest first (paginated; backs the /whd court ledger)GET /api/firm-attorneys: Law firm's attorneys (paginated)GET /api/person-employers: Employers a person (attorney/POC) has filed LCAs forGET /api/county-contracts: County federal contractsGET /api/county-lawfirms: County immigration law firmsGET /api/state-counties: State county H-1B rankingsGET /api/state-zips: State top ZIPs by H-1B volumeGET /api/agent-employers: Employers represented by a registered agent (sortable, paginated)GET /api/ghost-office: Ghost-office (shell-address) employer signals (sortable, paginated)GET /api/graph/expand: Expand graph neighbors for a node (employer/person/firm/agent/agency)GET /api/medical-shortage: Counties importing H-1B physicians despite adequate MD supply (the 'doctor shortage' counter-evidence)GET /api/state-hpsa-counties: State counties ranked by primary-care HPSA designationsGET /api/county-hpsas: Health Professional Shortage Areas in a countyGET /api/hpsa-hospitals: Hospitals in an HPSA-designated county with H-1B wage signalGET /api/soc-scoped-employers: Employers in a geo scope filtered by SOC prefix (live GROUP BY, medical/education verticals)GET /api/vertical-employers: Employer list for an industry vertical (tech/finance), geo-scoped, from the employer_vertical_stats MVGET /api/worksite-dots: Worksite dot-density points for the /map overlay (worksite_dot_grid MV, top cells by workers)GET /api/education-intl-concentration: Institutions by international-student concentration (IPEDS nonresident share)GET /api/health: Consolidated health probe (db, derived_data, ingest_pipeline, frank, ocr, disk, scheduler); 503 with body when degradedGET /api/indexnow/key: IndexNow key verification file (404 when INDEXNOW_KEY unset)GET /api/status: Public uptime/inventory status (data freshness snapshot)GET /api/chart.svg: Standalone chart export as native SVG (kind: wage-trend | denial-trend | trend)GET /api/chart.png: Standalone chart export as PNG (kind: wage-trend | denial-trend | trend; rate-limited)GET /api/ghost-office/networks: Ghost-office networks (clusters of employers at one shell address)GET /api/news: News wire pages: ?from/?to (YYYY-MM-DD) + ?page (1-based, ≤10000), optional ?sources (comma-separated source list)GET /api/news/poll: Wire liveness probe: newest story id + newest day + optional new-story count since ?since
The interactive reference below includes parameters and request examples. If it does not load, use the Markdown reference.