{"openapi": "3.0.3", "info": {"title": "SponsorLens API", "version": "0.1.0", "description": "Normalized, source-linked U.S. foreign-labor-certification records from the Department of Labor OFLC disclosure files \u2014 H-1B/H-1B1/E-3 (LCA), PERM, and H-2A/H-2B. Filter by employer, program, SOC occupation, worksite state, wage, or decision date; every record carries offered + prevailing wage (annualized for benchmarking) and links back to its official OFLC file, with a live per-program coverage map at /v1/programs/{program}/status. Updated quarterly. Informational use; not legal or immigration advice."}, "servers": [{"url": "https://sponsorlens-api.remulouslabs.com"}], "x-tiers": {"description": "Quota-only: every plan returns the same full data and all filters; plans differ only by monthly call quota, enforced by the RapidAPI gateway."}, "paths": {"/v1/certifications": {"get": {"summary": "Filtered certification list", "parameters": [{"name": "employer", "in": "query", "schema": {"type": "string"}}, {"name": "program", "in": "query", "schema": {"type": "string", "enum": ["h-1b", "h-1b1", "e-3", "perm", "h-2a", "h-2b", "cw-1", "prevailing-wage"]}}, {"name": "case_status", "in": "query", "schema": {"type": "string", "enum": ["certified", "certified-withdrawn", "denied", "withdrawn"]}}, {"name": "worksite_state", "in": "query", "schema": {"type": "string"}}, {"name": "soc_code", "in": "query", "schema": {"type": "string"}}, {"name": "ticker", "in": "query", "schema": {"type": "string"}}, {"name": "min_wage", "in": "query", "schema": {"type": "number"}, "description": "Minimum annualized offered wage (unit-agnostic)."}, {"name": "fiscal_year", "in": "query", "schema": {"type": "integer"}}, {"name": "decision_from", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "decision_to", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 50}}, {"name": "offset", "in": "query", "schema": {"type": "integer", "default": 0}}], "responses": {"200": {"description": "Certifications"}, "400": {"description": "Invalid parameter"}}}}, "/v1/certifications/{id}": {"get": {"summary": "One certification", "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Certification"}, "404": {"description": "Not found"}}}}, "/v1/employers/{name}/certifications": {"get": {"summary": "Sponsorship history for one employer", "parameters": [{"name": "name", "in": "path", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Certifications"}, "404": {"description": "None"}}}}, "/v1/wages": {"get": {"summary": "Wage percentiles by SOC / state / employer", "description": "Returns offered and prevailing wage percentiles (P25/P50/P75/P90 + mean) for the matching certifications. Wages are annualized to a yearly basis regardless of reported unit, so hourly and salaried roles compare directly. At least one of soc_code or employer is required.", "parameters": [{"name": "soc_code", "in": "query", "schema": {"type": "string"}, "description": "SOC occupation code, e.g. 15-1252"}, {"name": "employer", "in": "query", "schema": {"type": "string"}}, {"name": "ticker", "in": "query", "schema": {"type": "string"}, "description": "Parent-company stock ticker, e.g. NVDA (populated by entity resolution)."}, {"name": "worksite_state", "in": "query", "schema": {"type": "string"}}, {"name": "program", "in": "query", "schema": {"type": "string", "enum": ["h-1b", "h-1b1", "e-3", "perm", "h-2a", "h-2b", "cw-1", "prevailing-wage"]}}, {"name": "fiscal_year", "in": "query", "schema": {"type": "integer"}}, {"name": "certified_only", "in": "query", "schema": {"type": "boolean", "default": true}, "description": "Restrict to Certified cases only (default true)."}], "responses": {"200": {"description": "Wage statistics"}, "400": {"description": "Missing required filter or invalid parameter"}}}}, "/v1/programs/{program}/status": {"get": {"summary": "Per-program coverage / freshness", "parameters": [{"name": "program", "in": "path", "required": true, "schema": {"type": "string", "enum": ["h-1b", "h-1b1", "e-3", "perm", "h-2a", "h-2b", "cw-1", "prevailing-wage"]}}], "responses": {"200": {"description": "Coverage"}}}}, "/v1/meta": {"get": {"summary": "Totals, coverage, sources", "responses": {"200": {"description": "Metadata"}}}}, "/healthz": {"get": {"summary": "Liveness", "responses": {"200": {"description": "OK"}}}}}}