API Documentation — H1BWageCheck

Authentication

API Key

All API requests require an API key passed in the X-API-Key header. Free-tier users receive a key upon registration. Pro and Enterprise keys are provisioned after subscription.

Example Request Header

curl -H "X-API-Key: your_api_key_here" \
  https://h1bwagecheck.com/api/employer/search?q=google

Requests without a valid API key will receive a 401 Unauthorized response.

Rate Limits

API rate limits are based on your subscription tier. Limits reset daily at midnight UTC.

Tier	Daily Limit
Free	100 calls/day
Pro ($49/mo)	10,000 calls/day
Enterprise ($149/mo)	Unlimited

Rate limit status is returned in response headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1714003200

Exceeding your limit returns 429 Too Many Requests.

GET /api/employer/search

Search for employers by name. Returns matching employers sorted by total filings.

Parameter	Type	Description
`q`	string	Search query (employer name). Required.
`limit`	integer	Max results to return. Default: 10, max: 50.

Request

curl -H "X-API-Key: your_api_key_here" \
  "https://h1bwagecheck.com/api/employer/search?q=microsoft&limit=3"

Response

[
  {
    "name": "Microsoft Corporation",
    "slug": "microsoft-corporation",
    "city": "Redmond",
    "state": "WA",
    "total_filings": 48523
  },
  {
    "name": "Microsoft Cloud Operations",
    "slug": "microsoft-cloud-operations",
    "city": "Redmond",
    "state": "WA",
    "total_filings": 312
  }
]

GET /api/employer/{slug}

Get detailed information about a specific employer including wage statistics and filing history.

Parameter	Type	Description
`slug`	string	URL-friendly employer identifier. Required (path param).

Request

curl -H "X-API-Key: your_api_key_here" \
  "https://h1bwagecheck.com/api/employer/google-llc"

Response

{
  "name": "Google LLC",
  "slug": "google-llc",
  "city": "Mountain View",
  "state": "CA",
  "total_filings": 35812,
  "median_salary": 178000,
  "avg_salary": 182450,
  "min_salary": 85000,
  "max_salary": 425000,
  "top_occupations": [
    {"title": "Software Developers", "count": 12840},
    {"title": "Software Quality Assurance Analysts", "count": 3256}
  ],
  "filings_by_year": {
    "2024": 6218,
    "2023": 7102,
    "2022": 8340
  }
}

GET /api/city/{city-state}

Get H-1B filing data for a specific city, including top employers and wage statistics.

Parameter	Type	Description
`city-state`	string	City and state slug, e.g. `san-francisco-ca`. Required (path param).

Request

curl -H "X-API-Key: your_api_key_here" \
  "https://h1bwagecheck.com/api/city/san-francisco-ca"

Response

{
  "city": "San Francisco",
  "state": "CA",
  "total_filings": 89432,
  "median_salary": 165000,
  "top_employers": [
    {"name": "Salesforce Inc", "filings": 4521},
    {"name": "Wells Fargo Bank", "filings": 3890}
  ],
  "avg_salary": 168200
}

GET /api/top-employers

Get the top H-1B employers ranked by total LCA filings.

Parameter	Type	Description
`limit`	integer	Number of employers to return. Default: 20, max: 100.

Request

curl -H "X-API-Key: your_api_key_here" \
  "https://h1bwagecheck.com/api/top-employers?limit=5"

Response

[
  {"rank": 1, "name": "Infosys Limited", "slug": "infosys-limited", "filings": 72341},
  {"rank": 2, "name": "Tata Consultancy Services", "slug": "tata-consultancy-services", "filings": 58920},
  {"rank": 3, "name": "Cognizant Technology Solutions", "slug": "cognizant-technology-solutions", "filings": 45102},
  {"rank": 4, "name": "Amazon.com Services LLC", "slug": "amazon-com-services-llc", "filings": 41230},
  {"rank": 5, "name": "Microsoft Corporation", "slug": "microsoft-corporation", "filings": 38524}
]

GET /api/trending

Get employers with the highest recent filing growth (trending upward in H-1B activity).

Parameter	Type	Description
`limit`	integer	Number of results. Default: 10, max: 50.

Request

curl -H "X-API-Key: your_api_key_here" \
  "https://h1bwagecheck.com/api/trending?limit=3"

Response

[
  {
    "name": "OpenAI LLC",
    "slug": "openai-llc",
    "filings_current": 482,
    "filings_previous": 156,
    "growth_pct": 209.0
  },
  {
    "name": "Anthropic",
    "slug": "anthropic",
    "filings_current": 318,
    "filings_previous": 87,
    "growth_pct": 265.5
  }
]

GET /api/compare

Compare wage data between two employers side by side.

Parameter	Type	Description
`a`	string	First employer slug. Required.
`b`	string	Second employer slug. Required.

Request

curl -H "X-API-Key: your_api_key_here" \
  "https://h1bwagecheck.com/api/compare?a=google-llc&b=meta-platforms-inc"

Response

{
  "employer_a": {
    "name": "Google LLC",
    "median_salary": 178000,
    "total_filings": 35812,
    "avg_salary": 182450
  },
  "employer_b": {
    "name": "Meta Platforms Inc",
    "median_salary": 192000,
    "total_filings": 18456,
    "avg_salary": 196800
  },
  "median_diff": 14000,
  "median_diff_pct": 7.9
}

GET /api/occupation/{soc_code}

Get H-1B data for a specific occupation by SOC code.

Parameter	Type	Description
`soc_code`	string	Standard Occupational Classification code, e.g. `15-1252`. Required (path param).

Request

curl -H "X-API-Key: your_api_key_here" \
  "https://h1bwagecheck.com/api/occupation/15-1252"

Response

{
  "soc_code": "15-1252",
  "title": "Software Developers",
  "total_filings": 412380,
  "median_salary": 145000,
  "avg_salary": 148200,
  "top_employers": [
    {"name": "Infosys Limited", "count": 18240},
    {"name": "Tata Consultancy Services", "count": 14320}
  ],
  "salary_range": {
    "p10": 85000,
    "p25": 110000,
    "p75": 185000,
    "p90": 230000
  }
}

GET /api/wage-calculator/soc-search

Search for SOC occupation codes by keyword for use with the wage calculator.

Parameter	Type	Description
`q`	string	Search query (occupation title or keyword). Required.

Request

curl -H "X-API-Key: your_api_key_here" \
  "https://h1bwagecheck.com/api/wage-calculator/soc-search?q=software"

Response

[
  {"soc_code": "15-1252", "title": "Software Developers"},
  {"soc_code": "15-1253", "title": "Software Quality Assurance Analysts and Testers"},
  {"soc_code": "15-1254", "title": "Web Developers"}
]

GET /api/wage-calculator/area-search

Search for geographic wage areas by city or metro area name.

Parameter	Type	Description
`q`	string	Search query (city or area name). Required.

Request

curl -H "X-API-Key: your_api_key_here" \
  "https://h1bwagecheck.com/api/wage-calculator/area-search?q=seattle"

Response

[
  {"area_code": "42660", "area_title": "Seattle-Tacoma-Bellevue, WA"},
  {"area_code": "99999", "area_title": "Washington (Statewide)"}
]

GET /api/wage-calculator/calculate

Calculate prevailing wage levels for a specific occupation and area. Compares a given salary against DOL wage levels.

Parameter	Type	Description
`soc`	string	SOC occupation code, e.g. `15-1252`. Required.
`area`	string	Geographic area code, e.g. `42660`. Required.
`salary`	number	Annual salary to evaluate. Required.

Request

curl -H "X-API-Key: your_api_key_here" \
  "https://h1bwagecheck.com/api/wage-calculator/calculate?soc=15-1252&area=42660&salary=165000"

Response

{
  "soc_code": "15-1252",
  "soc_title": "Software Developers",
  "area_code": "42660",
  "area_title": "Seattle-Tacoma-Bellevue, WA",
  "input_salary": 165000,
  "wage_levels": {
    "level_1": 112278,
    "level_2": 138518,
    "level_3": 164757,
    "level_4": 190997
  },
  "determined_level": 3,
  "above_level_3_by": 243
}