KeyVex H1b Filings API
The H1b Filings API from KeyVex — 1 operation(s) for h1b filings.
The H1b Filings API from KeyVex — 1 operation(s) for h1b filings.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/keyvex-com:keyvex-com-h1b-filings-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: KeyVex H1b Filings API
version: 0.102.0
termsOfService: https://keyvex.com/terms
description: 'US public financial-disclosure data — congressional trades, insider filings (Form 4), lobbying, Treasury auctions, member profiles. Requires an API key — create a free one at https://keyvex.com and send it as the header `x-api-key: `. A free key returns most public-record datasets (one year of history; no market-price data and a few heavy datasets are on paid plans only), capped at 60 requests/day; paid plans raise the caps. The daily allowance resets at midnight Eastern.'
servers:
- url: https://api.keyvex.com
security:
- ApiKeyAuth: []
tags:
- name: H1b Filings
paths:
/v1/h1b-filings:
get:
operationId: get_h1b_filings
summary: Returns H-1B Labor Condition Applications from the Department of Labor's…
description: 'Returns H-1B Labor Condition Applications from the Department of Labor''s quarterly disclosure files — one record per LCA with employer, job title, O*NET-SOC occupation code, offered wage vs DOL prevailing wage, worksite location, and employer risk flags (h1b_dependent, willful_violator). Covers H-1B, H-1B1 (Chile / Singapore), and E-3 (Australia) visa classes. Use this when the user asks about: a company''s hiring activity or wage levels for specific roles, tech-hiring trends by state or occupation, offered vs prevailing wage gaps, or outsourcing-firm staffing patterns. IMPORTANT interpretation notes (stated so agents don''t over-read): an LCA is filed BEFORE the H-1B petition and can cover multiple positions (total_worker_positions) — it signals hiring INTENT, not an approved visa or a hire. Certified ≫ actual visas issued. Wage fields are as filed; wage_unit varies (Year / Hour / Month / Week / Bi-Weekly) — normalize before comparing. Matching: employer_name is a substring over legal name + DBA (e.g., ''infosys'', ''amazon''). soc_code is the precise occupation filter (e.g., ''15-1252.00'' Software Developers). case_status values: ''Certified'', ''Certified - Withdrawn'', ''Denied'', ''Withdrawn''. Coverage: FY2024→present from DOL''s quarterly files (fiscal_year / fiscal_quarter on each record; ~400-550K filings per quarter). Pure-publisher posture: DOL''s disclosure rows as filed — no derived ''real wage'' normalization or employer scoring.'
parameters:
- name: case_number
in: query
required: false
description: Direct lookup by DOL case number (e.g., 'I-200-26083-726723').
schema:
type: string
- name: employer_name
in: query
required: false
description: Case-insensitive substring against employer legal name + DBA (e.g., 'google', 'tata').
schema:
type: string
- name: job_title
in: query
required: false
description: Case-insensitive substring against the job title (e.g., 'machine learning').
schema:
type: string
- name: soc_code
in: query
required: false
description: Exact O*NET-SOC occupation code (e.g., '15-1252.00' = Software Developers).
schema:
type: string
- name: visa_class
in: query
required: false
description: 'Exact: ''H-1B'', ''H-1B1 Chile'', ''H-1B1 Singapore'', ''E-3 Australian''.'
schema:
type: string
- name: case_status
in: query
required: false
description: 'Exact: ''Certified'', ''Certified - Withdrawn'', ''Denied'', ''Withdrawn''.'
schema:
type: string
- name: worksite_state
in: query
required: false
description: Two-letter worksite state (e.g., 'CA', 'TX').
schema:
type: string
- name: since
in: query
required: false
description: Decision date lower bound (YYYY-MM-DD inclusive).
schema:
type: string
- name: until
in: query
required: false
description: Decision date upper bound (YYYY-MM-DD inclusive).
schema:
type: string
- name: sort_order
in: query
required: false
description: 'Default: desc (most recent decisions first).'
schema:
type: string
enum:
- asc
- desc
- name: limit
in: query
required: false
description: Maximum filings to return. Default 50, max 500.
schema:
type: integer
responses:
'200':
description: 'JSON envelope: { results: [...], count, has_more }.'
'400':
description: Invalid parameter.
'401':
description: Missing or invalid API key.
'402':
description: This tool requires a higher plan (upgrade_required). Retrying will not help.
'429':
description: Tier rate/quota limit reached (rate_limited). Retry-After points at the reset.
tags:
- H1b Filings
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key