---
title: "DOL H-1B LCA Search"
method: POST
path: "/us/dol-oflc/lca-search/v1"
tags: ["United States", "DOL H-1B and PERM"]
---

# DOL H-1B LCA Search

`POST /us/dol-oflc/lca-search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/us/dol-oflc/lca-search/v1`
- Auth: HTTP bearer

Search every Labor Condition Application DOL decided since fiscal year 2008 (the filing an employer makes to hire on an H-1B, H-1B1 or E-3 visa) by employer, trade name or job title, employer FEIN, case number, fiscal year, visa class, case status, SOC code, worksite state, minimum offered wage and decision dates. Each determination carries the employer, the job, the offered and prevailing wage, the primary worksite, the employer's contact, the attorney and Appendix A. Newest decision first, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date as DOL publishes each quarter.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Palabras a buscar en el empleador, su nombre comercial y el cargo (opcional).
  - `employer_fein` string: FEI/EIN de nueve dígitos de la entidad (opcional).
  - `case_number` string: Número de caso de DOL (opcional).
  - `fiscal_year` integer: Año fiscal federal (octubre a septiembre), p. ej. `2026` (opcional).
  - `visa_class` '' | 'H-1B' | 'H-1B1 Chile' | 'H-1B1 Singapore' | 'E-3 Australian': Clase de visa: `H-1B`, `H-1B1 Chile`, `H-1B1 Singapore` o `E-3 Australian` (opcional).
  - `case_status` '' | 'Certified' | 'Certified - Withdrawn' | 'Withdrawn' | 'Denied' | 'Rejected' | 'Invalidated': Estado del caso: `Certified`, `Certified - Withdrawn`, `Withdrawn`, `Denied`, `Rejected` o `Invalidated` (opcional).
  - `soc_code` string: Código SOC de la ocupación, p. ej. `15-1252.00` (opcional).
  - `worksite_state` string: Código de estado de dos letras, p. ej. `FL` (opcional).
  - `min_wage` number: Monto mínimo, en dólares (opcional).
  - `decided_from` string, date: Optional date filter in yyyy-mm-dd format.
  - `decided_to` string, date: Optional date filter in yyyy-mm-dd format.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Resultados por página (1-50).

## Response `200`

Successful response

- DolOflcLcaSearchResponse
  - `data` DolOflcLcaSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `query` string, required
    - `employer_fein` string, nullable, required
    - `case_number` string, nullable, required
    - `fiscal_year` number, nullable, required
    - `visa_class` string, nullable, required
    - `case_status` string, nullable, required
    - `soc_code` string, nullable, required
    - `worksite_state` string, nullable, required
    - `min_wage` number, nullable, required
    - `decided_from` string, nullable, required
    - `decided_to` string, nullable, required
    - `total` number, required: Matches, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required
    - `count` number, required
    - `cases` object[], required
      - `id` string, required: `<fiscal_year>:<case_number>`: a case decided again in a later fiscal year (a certification withdrawn) is a row of its own, and a second, different filing a year's file lists under the same number is `<fiscal_year>:<case_number>~2`.
      - `fiscal_year` integer, required: The federal fiscal year (October to September) DOL published the determination under.
      - `case_number` string, required: DOL's case number, e.g. `I-200-25267-332158`.
      - `case_status` string, required: `Certified`, `Certified - Withdrawn`, `Withdrawn` or `Denied`.
      - `received_date` string, nullable, required
      - `decision_date` string, nullable, required
      - `original_cert_date` string, nullable, required: For a certification later withdrawn, when it was first certified.
      - `visa_class` string, nullable, required: `H-1B`, `H-1B1 Chile`, `H-1B1 Singapore` or `E-3 Australian`.
      - `job_title` string, nullable, required
      - `soc_code` string, nullable, required: The Standard Occupational Classification code, e.g. `15-1252.00`.
      - `soc_title` string, nullable, required
      - `full_time_position` boolean, nullable, required
      - `begin_date` string, nullable, required
      - `end_date` string, nullable, required
      - `total_worker_positions` integer, nullable, required
      - `new_employment` integer, nullable, required
      - `continued_employment` integer, nullable, required
      - `change_previous_employment` integer, nullable, required
      - `new_concurrent_employment` integer, nullable, required
      - `change_employer` integer, nullable, required
      - `amended_petition` integer, nullable, required
      - `employer` object, required
        - `name` string, nullable, required
        - `trade_name_dba` string, nullable, required
        - `address_1` string, nullable, required
        - `address_2` string, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required
        - `postal_code` string, nullable, required
        - `country` string, nullable, required
        - `province` string, nullable, required
        - `phone` string, nullable, required
        - `phone_ext` string, nullable, required
        - `fein` string, nullable, required: The employer's Federal Employer Identification Number, nine digits (published from fiscal year 2024).
        - `naics_code` string, nullable, required
      - `employer_contact` object, required: The employer's point of contact for the filing.
        - `last_name` string, nullable, required
        - `first_name` string, nullable, required
        - `middle_name` string, nullable, required
        - `job_title` string, nullable, required
        - `address_1` string, nullable, required
        - `address_2` string, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required
        - `postal_code` string, nullable, required
        - `country` string, nullable, required
        - `province` string, nullable, required
        - `phone` string, nullable, required
        - `phone_ext` string, nullable, required
        - `email` string, nullable, required
      - `agent_representing_employer` boolean, nullable, required
      - `agent_attorney` object, required
        - `last_name` string, nullable, required
        - `first_name` string, nullable, required
        - `middle_name` string, nullable, required
        - `address_1` string, nullable, required
        - `address_2` string, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required
        - `postal_code` string, nullable, required
        - `country` string, nullable, required
        - `province` string, nullable, required
        - `phone` string, nullable, required
        - `phone_ext` string, nullable, required
        - `email` string, nullable, required
      - `law_firm` object, required
        - `name` string, nullable, required
        - `fein` string, nullable, required
      - `state_of_highest_court` string, nullable, required
      - `name_of_highest_state_court` string, nullable, required
      - `worksite` object, required: The primary worksite; every worksite is in `lca-worksites`.
        - `workers` integer, nullable, required
        - `secondary_entity` boolean, nullable, required: The worker is placed with another company.
        - `secondary_entity_business_name` string, nullable, required
        - `address_1` string, nullable, required
        - `address_2` string, nullable, required
        - `city` string, nullable, required
        - `county` string, nullable, required
        - `state` string, nullable, required: The primary worksite's state.
        - `postal_code` string, nullable, required
      - `wage` object, required
        - `rate_from` number, nullable, required: The offered wage, US dollars per `unit`.
        - `rate_to` number, nullable, required
        - `unit` string, nullable, required: `Year`, `Month`, `Bi-Weekly`, `Week` or `Hour`.
        - `prevailing_wage` number, nullable, required
        - `prevailing_wage_unit` string, nullable, required
        - `prevailing_wage_tracking_number` string, nullable, required
        - `prevailing_wage_level` string, nullable, required: `I` to `IV`.
        - `prevailing_wage_oes_year` string, nullable, required
        - `prevailing_wage_other_source` string, nullable, required
        - `prevailing_wage_other_year` string, nullable, required
        - `prevailing_wage_survey_publisher` string, nullable, required
        - `prevailing_wage_survey_name` string, nullable, required
      - `total_worksite_locations` integer, nullable, required
      - `agree_to_lc_statement` boolean, nullable, required
      - `h1b_dependent` boolean, nullable, required: The employer is H-1B dependent.
      - `willful_violator` boolean, nullable, required
      - `support_h1b` boolean, nullable, required
      - `statutory_basis` string, nullable, required
      - `appendix_a_attached` boolean, nullable, required
      - `public_disclosure` string, nullable, required
      - `preparer` object, required
        - `last_name` string, nullable, required
        - `first_name` string, nullable, required
        - `middle_initial` string, nullable, required
        - `business_name` string, nullable, required
        - `email` string, nullable, required
      - `appendix_a` object[], required: Appendix A: the exempt workers' highest degree, when the employer claims the exemption.
        - `exempt_workers` integer, nullable, required
        - `institution` string, nullable, required
        - `field_of_study` string, nullable, required
        - `degree_date` string, nullable, required
      - `answers` object: Columns only files before fiscal year 2020 carry, under their name in lower case (`withdrawn`, `job_code`, `agent_attorney_name`), as filed; empty for later years.
      - `source_file` string, required: The DOL disclosure file the row was read from.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)
