> ## 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.
# MTE (registro de trabajo esclavo)
> El registro brasileño de empleadores que sometieron trabajadores a condiciones análogas a la esclavitud (la "Lista Suja"), y el de empleadores en ajuste de conducta, con búsqueda por CNPJ, CPF, nombre, estado y año, actualizados a diario.
El ministerio de trabajo de Brasil publica a los empleadores que sus
inspectores encontraron sometiendo trabajadores a condiciones análogas a la
esclavitud, una vez firme el proceso administrativo, y mantiene a cada uno
dos años en la lista. Las reglas del banco central prohíben el crédito rural
a quien figure en ella, y los bancos la consultan en sus controles ESG y KYC.
Un segundo registro lista a los empleadores que firmaron en su lugar un
acuerdo de ajuste de conducta.
Busca en ambos por CNPJ (o su raíz, para todas las sucursales), CPF, nombre,
estado o año de la fiscalización, y obtén cada inclusión con el
establecimiento, los trabajadores encontrados, la actividad y cada período en
el registro.
La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
## Buscar en el registro
`POST /br/mte/slave-labour-search/v1` Dataset
Encuentra empleadores en los registros por documento, nombre, estado o año.
| Campo | Tipo | Notas |
| ----------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palabras del nombre del empleador o del establecimiento, p. ej. `fazenda`. Deben coincidir todas. |
| `document_number` | string | Opcional. Un CNPJ o CPF, con o sin puntuación, coincidencia exacta; o los primeros 8 caracteres de un CNPJ para todas sus sucursales. |
| `list` | enum | Opcional. `slave_labour` o `conduct_adjustment`; ambos por defecto. |
| `party_type` | enum | Opcional. `individual` (por CPF) o `company` (por CNPJ). |
| `state` | string | Opcional. Sigla del estado de la fiscalización, p. ej. `PA`. |
| `inspection_year` | integer | Opcional. Año de la fiscalización, p. ej. `2024`. Por defecto `0`. |
| `page` | integer | Opcional. Página, desde 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por defecto `20`. |
```bash theme={"dark"}
curl https://api.croma.run/br/mte/slave-labour-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "fazenda" }'
```
Cada empleador es `{ id, list, party_type, document_type, document, employer_name, establishment, state, inspection_year, workers_involved, cnae, final_decision_date, listed_on, listing_history[], court_order, conduct_adjustment_on, agreement_url }`.
* `list`: `slave_labour` (el registro de empleadores que sometieron trabajadores a condiciones análogas a la esclavitud) o `conduct_adjustment` (empleadores que firmaron un acuerdo de ajuste de conducta y salen del primer registro).
* `document`: un CNPJ completo; un CPF enmascarado (`***.456.789-**`). Un CPF escrito dentro de un nombre también se enmascara.
* `listed_on`: cuándo empezó la inclusión vigente; `listing_history[]` es cada período en el registro, `{ from, to }`, porque un tribunal puede suspender una inclusión y esta puede volver.
* `court_order`: la decisión judicial que incluyó al empleador, cuando fue un tribunal.
Un empleador permanece en el registro dos años. Cuando sale, sale de los datos
el mismo día: una búsqueda por su documento responde `total: 0` y su id
responde `found: false`.
## Una inclusión
`POST /br/mte/employer/v1` Dataset
Devuelve una inclusión por su id.
| Campo | Tipo | Notas |
| ----- | ------ | ---------------------------------------------------------------------------------------- |
| `id` | string | **Obligatorio.** **Obligatorio.** El `id` de la inclusión, como lo devuelve la búsqueda. |
```bash theme={"dark"}
curl https://api.croma.run/br/mte/employer/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "id": "slave_labour-3f9a0c12d4e5b6a7" }'
```
Cada empleador es `{ id, list, party_type, document_type, document, employer_name, establishment, state, inspection_year, workers_involved, cnae, final_decision_date, listed_on, listing_history[], court_order, conduct_adjustment_on, agreement_url }`.
* `list`: `slave_labour` (el registro de empleadores que sometieron trabajadores a condiciones análogas a la esclavitud) o `conduct_adjustment` (empleadores que firmaron un acuerdo de ajuste de conducta y salen del primer registro).
* `document`: un CNPJ completo; un CPF enmascarado (`***.456.789-**`). Un CPF escrito dentro de un nombre también se enmascara.
* `listed_on`: cuándo empezó la inclusión vigente; `listing_history[]` es cada período en el registro, `{ from, to }`, porque un tribunal puede suspender una inclusión y esta puede volver.
* `court_order`: la decisión judicial que incluyó al empleador, cuando fue un tribunal.
Un empleador permanece en el registro dos años. Cuando sale, sale de los datos
el mismo día: una búsqueda por su documento responde `total: 0` y su id
responde `found: false`.
Esquemas, todos los campos de respuesta y un playground interactivo.