{"openapi":"3.1.0","info":{"title":"H-1B Salary Data API","version":"0.1.0","description":"The H-1B Salary Data API provides programmatic access to over 8 million H-1B visa salary records sourced from the U.S. Department of Labor (DOL) Office of Foreign Labor Certification (OFLC) LCA filings. All salaries are normalized to annual figures regardless of the original wage unit (hourly, weekly, biweekly, monthly). Features include: fuzzy employer and job title search, filtering by SOC occupation code, state, city, salary range, wage level, and case status. Results are paginated and sortable. Use this API to answer questions like 'How much does Google pay Software Engineers in California?' or 'What is the median H-1B salary for Data Scientists in New York?'. Data is updated quarterly from public DOL/OFLC disclosure files. Free tier available. Paid plans from $9/mo."},"components":{"schemas":{},"parameters":{}},"paths":{"/api/v1/salaries":{"get":{"tags":["Salaries"],"summary":"Search H-1B salary filings","description":"Search and filter H-1B visa salary data from DOL/OFLC LCA filings. All salaries are normalized to annual. Supports employer search, location filter, salary range, and pagination. Requires API key. Free tier: last 2 fiscal years, 6 fields, 25 results/page. Paid tiers: all years, all 19 fields, up to 100 results/page.","parameters":[{"schema":{"type":"string","example":"google"},"required":false,"name":"employer","in":"query"},{"schema":{"type":"string","example":"software engineer"},"required":false,"name":"job_title","in":"query"},{"schema":{"type":"string","pattern":"^\\d{2}-\\d{4}(\\.\\d{2})?$","example":"15-1252"},"required":false,"name":"soc_code","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":2,"example":"CA"},"required":false,"name":"state","in":"query"},{"schema":{"type":"string","example":"Mountain View"},"required":false,"name":"city","in":"query"},{"schema":{"type":"integer","nullable":true,"example":2024},"required":false,"name":"fiscal_year","in":"query"},{"schema":{"type":"number","nullable":true,"example":100000},"required":false,"name":"min_salary","in":"query"},{"schema":{"type":"number","nullable":true,"example":300000},"required":false,"name":"max_salary","in":"query"},{"schema":{"type":"string","enum":["Certified","Denied","Withdrawn","Certified - Withdrawn"],"example":"Certified"},"required":false,"name":"case_status","in":"query"},{"schema":{"type":"string","enum":["I","II","III","IV"],"example":"III"},"required":false,"name":"wage_level","in":"query"},{"schema":{"type":"string","enum":["salary_asc","salary_desc","date"],"default":"salary_desc","example":"salary_desc"},"required":false,"name":"sort","in":"query"},{"schema":{"type":"integer","minimum":1,"default":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"required":false,"name":"per_page","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"Include rows with suspect salary data"},"required":false,"name":"include_suspect","in":"query"}],"responses":{"200":{"description":"Salary search results","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"employer":{"type":"string"},"job_title":{"type":"string"},"salary_min":{"type":"number"},"worksite_city":{"type":"string","nullable":true},"worksite_state":{"type":"string"},"fiscal_year":{"type":"number"},"case_number":{"type":"string"},"case_status":{"type":"string"},"soc_code":{"type":"string","nullable":true},"soc_title":{"type":"string","nullable":true},"salary_max":{"type":"number","nullable":true},"wage_unit_original":{"type":"string"},"prevailing_wage_annual":{"type":"number","nullable":true},"wage_level":{"type":"string","nullable":true},"full_time":{"type":"boolean"},"visa_class":{"type":"string"},"salary_suspect":{"type":"boolean"},"received_date":{"type":"string","nullable":true},"decision_date":{"type":"string","nullable":true}},"required":["employer","job_title","salary_min","worksite_city","worksite_state","fiscal_year"]}},"meta":{"type":"object","properties":{"page":{"type":"number"},"per_page":{"type":"number"},"has_more":{"type":"boolean"}},"required":["page","per_page","has_more"]}},"required":["results","meta"]}}}},"400":{"description":"Bad request (missing filters)"},"403":{"description":"Tier restriction (fiscal year, pagination depth)"}}}}}}