> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# DOL H-1B e PERM: certificações trabalhistas
> Todas as Labor Condition Applications H-1B e todas as certificações trabalhistas PERM que o DOL decidiu desde o ano fiscal 2008, as solicitações que um empregador apresenta para contratar um trabalhador estrangeiro e para patrociná-lo para o green card: o empregador e seu FEIN, o cargo, o salário, os locais de trabalho, o advogado e a decisão.
Antes que um empregador dos EUA possa contratar um trabalhador com visto H-1B
(ou H-1B1 ou E-3), ele apresenta uma Labor Condition Application ao
Departamento do Trabalho: o cargo e seu código de ocupação, o salário que
pagará frente ao salário prevalecente da função, cada local onde a pessoa vai
trabalhar, e o advogado que a apresentou. A Office of Foreign Labor
Certification do DOL a certifica ou nega, e publica cada decisão.
É o registro público mais direto de quais cargos uma empresa contrata no
exterior e quanto paga. Todas as decisões desde o ano fiscal 2008, com cada
local de trabalho, organizadas e prontas para consultar, e atualizadas à
medida que o DOL publica cada trimestre. O FEIN do empregador, publicado desde
o ano fiscal 2024, liga uma solicitação exatamente aos filings da mesma
empresa na SEC.
Para patrocinar um trabalhador para a residência permanente, o empregador
apresenta depois uma certificação trabalhista PERM: o cargo e seus requisitos,
o salário oferecido e o prevalecente, como recrutou primeiro trabalhadores dos
EUA e, no formulário usado até 2023, a cidadania, o visto atual e a educação
do trabalhador. Todas as decisões PERM desde o ano fiscal 2008 também estão
aqui, nos dois formulários.
A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
## Buscar decisões LCA
`POST /us/dol-oflc/lca-search/v1` Dataset
Busca as decisões por empregador, cargo, FEIN, classe de visto, status,
ocupação, estado do local de trabalho, salário e data. As mais recentes primeiro.
| Campo | Tipo | Notas |
| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `query` | string | Opcional. Palavras a buscar no nome do empregador, seu nome comercial e o cargo. Todas as palavras devem coincidir; sem lematização. |
| `employer_fein` | string | Opcional. O FEIN do empregador, nove dígitos, com ou sem hífen (publicado desde o ano fiscal 2024). |
| `case_number` | string | Opcional. O número de caso do DOL, p. ex. `I-200-25267-332158`. |
| `fiscal_year` | integer | Opcional. O ano fiscal federal em que o DOL publicou a decisão (outubro a setembro), p. ex. `2026`. Por padrão `0`. |
| `visa_class` | enum | Opcional. `H-1B`, `H-1B1 Chile`, `H-1B1 Singapore` ou `E-3 Australian`. |
| `case_status` | enum | Opcional. `Certified`, `Certified - Withdrawn`, `Withdrawn` ou `Denied`. |
| `soc_code` | string | Opcional. O código SOC da ocupação, p. ex. `15-1252.00` (desenvolvedores de software). |
| `worksite_state` | string | Opcional. O estado do local de trabalho principal, duas letras, p. ex. `CA`. |
| `min_wage` | number | Opcional. Apenas decisões que oferecem pelo menos este salário (na unidade do salário, quase sempre anual). Por padrão `0`. |
| `decided_from` | string | Opcional. Limite inferior da data de decisão (`yyyy-mm-dd`, inclusive). |
| `decided_to` | string | Opcional. Limite superior da data de decisão (`yyyy-mm-dd`, inclusive). |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por padrão `20`. |
```bash theme={"dark"}
curl https://api.croma.run/us/dol-oflc/lca-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "software engineer",
"worksite_state": "CA",
"case_status": "Certified"
}'
```
Retorna `as_of`, os filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` e `cases[]`, da decisão mais recente à mais antiga.
Cada decisão traz `id` (`:`), `fiscal_year`, `case_number`, `case_status`, `received_date`, `decision_date`, `original_cert_date`, `visa_class`, `job_title`, `soc_code`, `soc_title`, `full_time_position`, `begin_date`, `end_date`, as contagens de trabalhadores (`total_worker_positions`, `new_employment`, `continued_employment`, `change_previous_employment`, `new_concurrent_employment`, `change_employer`, `amended_petition`), `employer` (`{ name, trade_name_dba, address_1, address_2, city, state, postal_code, country, province, phone, phone_ext, fein, naics_code }`), `employer_contact` (nome, cargo, endereço, telefone e e-mail), `agent_representing_employer`, `agent_attorney` (nome, endereço, telefone e e-mail), `law_firm` (`{ name, fein }`), `state_of_highest_court`, `name_of_highest_state_court`, `worksite` (o principal), `wage` (`{ rate_from, rate_to, unit, prevailing_wage, prevailing_wage_unit, prevailing_wage_level, ... }`), `total_worksite_locations`, `agree_to_lc_statement`, `h1b_dependent`, `willful_violator`, `support_h1b`, `statutory_basis`, `appendix_a_attached`, `public_disclosure`, `preparer`, `appendix_a[]` (a instituição, a área de estudo e a data do diploma dos trabalhadores isentos), `answers` (as colunas que só os arquivos anteriores ao ano fiscal 2020 trazem, como `withdrawn` ou `job_code`, como foram apresentadas) e `source_file`.
Um caso que o DOL decidiu de novo em um ano fiscal posterior (uma certificação depois retirada) é uma decisão própria, e uma segunda solicitação diferente que o arquivo de um ano lista com o mesmo número é `:~2`. Os arquivos anteriores ao ano fiscal 2020 publicam menos colunas: o que não trazem é `null`. Os salários são dólares por `unit`. As datas são `yyyy-mm-dd`; os FEIN têm nove dígitos; os campos vazios são `null`.
## Um caso LCA
`POST /us/dol-oflc/lca-case/v1` Dataset
Resolve um caso com cada decisão e seus locais de trabalho.
| Campo | Tipo | Notas |
| ------------- | ------ | ---------------------------------------------------------------------- |
| `case_number` | string | **Obrigatório.** O número de caso do DOL, p. ex. `I-200-25267-332158`. |
```bash theme={"dark"}
curl https://api.croma.run/us/dol-oflc/lca-case/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "case_number": "I-200-25267-332158" }'
```
Retorna `found`, `case_number`, `as_of`, `determinations[]` (do ano fiscal mais recente ao mais antigo) e `worksites[]` (da decisão mais recente).
Cada decisão traz `id` (`:`), `fiscal_year`, `case_number`, `case_status`, `received_date`, `decision_date`, `original_cert_date`, `visa_class`, `job_title`, `soc_code`, `soc_title`, `full_time_position`, `begin_date`, `end_date`, as contagens de trabalhadores (`total_worker_positions`, `new_employment`, `continued_employment`, `change_previous_employment`, `new_concurrent_employment`, `change_employer`, `amended_petition`), `employer` (`{ name, trade_name_dba, address_1, address_2, city, state, postal_code, country, province, phone, phone_ext, fein, naics_code }`), `employer_contact` (nome, cargo, endereço, telefone e e-mail), `agent_representing_employer`, `agent_attorney` (nome, endereço, telefone e e-mail), `law_firm` (`{ name, fein }`), `state_of_highest_court`, `name_of_highest_state_court`, `worksite` (o principal), `wage` (`{ rate_from, rate_to, unit, prevailing_wage, prevailing_wage_unit, prevailing_wage_level, ... }`), `total_worksite_locations`, `agree_to_lc_statement`, `h1b_dependent`, `willful_violator`, `support_h1b`, `statutory_basis`, `appendix_a_attached`, `public_disclosure`, `preparer`, `appendix_a[]` (a instituição, a área de estudo e a data do diploma dos trabalhadores isentos), `answers` (as colunas que só os arquivos anteriores ao ano fiscal 2020 trazem, como `withdrawn` ou `job_code`, como foram apresentadas) e `source_file`.
Um caso que o DOL decidiu de novo em um ano fiscal posterior (uma certificação depois retirada) é uma decisão própria, e uma segunda solicitação diferente que o arquivo de um ano lista com o mesmo número é `:~2`. Os arquivos anteriores ao ano fiscal 2020 publicam menos colunas: o que não trazem é `null`. Os salários são dólares por `unit`. As datas são `yyyy-mm-dd`; os FEIN têm nove dígitos; os campos vazios são `null`.
Cada local de trabalho traz `id` (`::`), `fiscal_year`, `case_number`, `n` (sua ordem no caso), `workers`, `secondary_entity`, `secondary_entity_business_name`, o endereço (`address_1`, `address_2`, `city` como foi apresentada, `county`, `state` em código de duas letras, `postal_code`), `city_key` (a cidade normalizada para busca: `AUSTIN` para `Austin, TX`), o salário oferecido ali (`rate_from`, `rate_to`, `unit`) e seu salário prevalecente, o `employer_fein` e `employer_name` do caso, e `answers` (o que só os arquivos anteriores ao ano fiscal 2020 trazem para um local de trabalho). Até o ano fiscal 2019 os locais de trabalho saem das linhas do caso: dois por caso no máximo até 2014, um de 2015 a 2018, até dez em 2019.
## Buscar locais de trabalho
`POST /us/dol-oflc/lca-worksites-search/v1` Dataset
Busca cada local de trabalho por lugar, empregador e ano.
| Campo | Tipo | Notas |
| --------------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| `employer_fein` | string | Opcional. O FEIN do empregador, nove dígitos, com ou sem hífen (publicado desde o ano fiscal 2024). |
| `case_number` | string | Opcional. O número de caso do DOL: todos os locais de trabalho de um caso. |
| `fiscal_year` | integer | Opcional. O ano fiscal federal em que o DOL publicou a decisão (outubro a setembro), p. ex. `2026`. Por padrão `0`. |
| `state` | string | Opcional. O estado do local de trabalho, duas letras, p. ex. `TX`. |
| `city` | string | Opcional. A cidade do local de trabalho, em maiúsculas ou minúsculas, p. ex. `Austin`. |
| `postal_code` | string | Opcional. O código postal de cinco dígitos do local de trabalho. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por padrão `20`. |
```bash theme={"dark"}
curl https://api.croma.run/us/dol-oflc/lca-worksites-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "city": "Austin", "state": "TX" }'
```
Retorna `as_of`, os filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` e `worksites[]`, do ano fiscal mais recente ao mais antigo.
Cada local de trabalho traz `id` (`::`), `fiscal_year`, `case_number`, `n` (sua ordem no caso), `workers`, `secondary_entity`, `secondary_entity_business_name`, o endereço (`address_1`, `address_2`, `city` como foi apresentada, `county`, `state` em código de duas letras, `postal_code`), `city_key` (a cidade normalizada para busca: `AUSTIN` para `Austin, TX`), o salário oferecido ali (`rate_from`, `rate_to`, `unit`) e seu salário prevalecente, o `employer_fein` e `employer_name` do caso, e `answers` (o que só os arquivos anteriores ao ano fiscal 2020 trazem para um local de trabalho). Até o ano fiscal 2019 os locais de trabalho saem das linhas do caso: dois por caso no máximo até 2014, um de 2015 a 2018, até dez em 2019.
## Buscar decisões PERM
`POST /us/dol-oflc/perm-search/v1` Dataset
Busca as decisões PERM por empregador, cargo, escritório, FEIN, status, ocupação,
estado do local de trabalho, cidadania do trabalhador, salário e data. As mais recentes primeiro.
| Campo | Tipo | Notas |
| ------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palavras a buscar no nome do empregador, seu nome comercial, o cargo e o escritório. Todas as palavras devem coincidir; sem lematização. |
| `employer_fein` | string | Opcional. O FEIN do empregador, nove dígitos, com ou sem hífen (publicado desde o ano fiscal 2024). |
| `case_number` | string | Opcional. O número de caso PERM do DOL, p. ex. `G-100-25273-349207` ou `A-23043-00641`. |
| `fiscal_year` | integer | Opcional. O ano fiscal federal em que o DOL publicou a decisão (outubro a setembro), p. ex. `2026`. Por padrão `0`. |
| `case_status` | enum | Opcional. `Certified`, `Certified - Expired`, `Withdrawn` ou `Denied`. |
| `soc_code` | string | Opcional. O código SOC da ocupação, p. ex. `15-1252.00` (desenvolvedores de software). |
| `worksite_state` | string | Opcional. O estado do local de trabalho, duas letras, p. ex. `WA`. |
| `country_of_citizenship` | string | Opcional. O país de cidadania do trabalhador como o DOL escreve, em inglês, p. ex. `INDIA` (só o formulário usado até 2023). |
| `min_wage` | number | Opcional. Apenas decisões que oferecem pelo menos este salário (na unidade do salário, quase sempre anual). Por padrão `0`. |
| `decided_from` | string | Opcional. Limite inferior da data de decisão (`yyyy-mm-dd`, inclusive). |
| `decided_to` | string | Opcional. Limite superior da data de decisão (`yyyy-mm-dd`, inclusive). |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por padrão `20`. |
```bash theme={"dark"}
curl https://api.croma.run/us/dol-oflc/perm-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "software engineer",
"worksite_state": "WA",
"case_status": "Certified"
}'
```
Retorna `as_of`, os filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` e `cases[]`, da decisão mais recente à mais antiga.
Cada decisão traz `id` (`:`), `fiscal_year`, `case_number`, `form` (`9089` para o formulário usado até 2023, `9089_2023` para o revisado), `case_status`, `received_date`, `decision_date`, `decision_dates[]`, `employer` (`{ name, trade_name, address_1, address_2, city, state, postal_code, country, province, phone, phone_ext, fein, naics_code, employees, year_commenced, worker_ownership_interest, relationship_to_worker }`), `employer_contact` (nome, cargo, endereço, telefone e e-mail), `agent_attorney` (`representative_type`, nome, `law_firm`, `law_firm_fein`, `state_bar_number`, `good_standing_state`, `good_standing_court`, endereço, telefone e e-mail), `job` (`{ title, soc_code, soc_title, occupation_type }`), `wage` (`{ offer_from, offer_to, offer_unit, offer_conditions, prevailing_wage, prevailing_wage_unit, prevailing_wage_level, prevailing_wage_source, prevailing_wage_tracking_number, ... }`), `worksite` (`{ type, address_1, address_2, city, county, state, postal_code, bls_area, multiple_locations }`), `worker` (o `country_of_citizenship`, `birth_country`, `class_of_admission`, `education`, `major`, `institution` e seu endereço, e `currently_employed` do trabalhador estrangeiro), `preparer`, `answers` e `source_file`.
Os dois formulários fazem perguntas diferentes: um campo que um formulário não pergunta é `null`, e `worker` só vem preenchido no formulário usado até 2023 (o revisado passou o trabalhador para um anexo que o DOL não publica). `answers` guarda cada outra resposta do formulário sob o nome de coluna do DOL em minúsculas (requisitos, recrutamento, avisos, declarações), como foi apresentada. Os salários são dólares por `offer_unit`. As datas são `yyyy-mm-dd`; os FEIN têm nove dígitos; os estados vêm em código de duas letras quando a solicitação nomeia um estado dos EUA.
## Um caso PERM
`POST /us/dol-oflc/perm-case/v1` Dataset
Resolve um caso PERM com cada decisão.
| Campo | Tipo | Notas |
| ------------- | ------ | ---------------------------------------------------------------------------------------------- |
| `case_number` | string | **Obrigatório.** O número de caso PERM do DOL, p. ex. `G-100-25273-349207` ou `A-23043-00641`. |
```bash theme={"dark"}
curl https://api.croma.run/us/dol-oflc/perm-case/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "case_number": "G-100-25273-349207" }'
```
Retorna `found`, `case_number`, `as_of` e `determinations[]`, do ano fiscal mais recente ao mais antigo.
Cada decisão traz `id` (`:`), `fiscal_year`, `case_number`, `form` (`9089` para o formulário usado até 2023, `9089_2023` para o revisado), `case_status`, `received_date`, `decision_date`, `decision_dates[]`, `employer` (`{ name, trade_name, address_1, address_2, city, state, postal_code, country, province, phone, phone_ext, fein, naics_code, employees, year_commenced, worker_ownership_interest, relationship_to_worker }`), `employer_contact` (nome, cargo, endereço, telefone e e-mail), `agent_attorney` (`representative_type`, nome, `law_firm`, `law_firm_fein`, `state_bar_number`, `good_standing_state`, `good_standing_court`, endereço, telefone e e-mail), `job` (`{ title, soc_code, soc_title, occupation_type }`), `wage` (`{ offer_from, offer_to, offer_unit, offer_conditions, prevailing_wage, prevailing_wage_unit, prevailing_wage_level, prevailing_wage_source, prevailing_wage_tracking_number, ... }`), `worksite` (`{ type, address_1, address_2, city, county, state, postal_code, bls_area, multiple_locations }`), `worker` (o `country_of_citizenship`, `birth_country`, `class_of_admission`, `education`, `major`, `institution` e seu endereço, e `currently_employed` do trabalhador estrangeiro), `preparer`, `answers` e `source_file`.
Os dois formulários fazem perguntas diferentes: um campo que um formulário não pergunta é `null`, e `worker` só vem preenchido no formulário usado até 2023 (o revisado passou o trabalhador para um anexo que o DOL não publica). `answers` guarda cada outra resposta do formulário sob o nome de coluna do DOL em minúsculas (requisitos, recrutamento, avisos, declarações), como foi apresentada. Os salários são dólares por `offer_unit`. As datas são `yyyy-mm-dd`; os FEIN têm nove dígitos; os estados vêm em código de duas letras quando a solicitação nomeia um estado dos EUA.
Esquemas, todos os campos de resposta e um playground interativo.