---
url: https://developers.zarv.com/api/id-v3/datasets/person-lawsuits-1-0.md
description: >-
  Zarv ID v3: formato de data.lawsuits do dataset person-lawsuits-1.0. Processos
  judiciais de um CPF classificados na taxonomia do CNJ, de uma fonte…
---

# lawsuits 1.0 · Pessoa

Processos judiciais de um CPF classificados na taxonomia do CNJ, de uma fonte processual: contadores por natureza, janelas de tempo, indicadores, e cada processo por inteiro.

|          |                                      |
| -------- | ------------------------------------ |
| Entidade | Pessoa (CPF, `entity: pf`)           |
| Módulo   | `lawsuits`                           |
| Versão   | `1.0`                                |
| Dataset  | `person-lawsuits-1.0`                |
| Execução | Roda quando o perfil inclui o módulo |

Este é o formato de `data.lawsuits` em [`GET /api/v3/enrichments/{id}?include=lawsuits`](/api/id-v3/getEnrichment) e o corpo de [`GET /api/v3/enrichments/{id}/modules/lawsuits`](/api/id-v3/getEnrichmentModule). Os campos são publicados como o dataset os entrega: um campo ausente significa que o dado não foi obtido, não que o valor é falso ou zero. Os caminhos abaixo são relativos a `data.lawsuits`.

## Envelope

| Campo      | Tipo            | Observação                                     |
| ---------- | --------------- | ---------------------------------------------- |
| `dataset`  | `string`        | sempre `person-lawsuits-1.0`                   |
| `module`   | `string`        | sempre `lawsuits`                              |
| `lawsuits` | `object`        | os dados do módulo (abaixo)                    |
| `rules`    | `array<object>` | os indicadores avaliados pelo dataset (abaixo) |

## Dados

### `coverage`

| Campo                                       | Tipo      | Observação |
| ------------------------------------------- | --------- | ---------- |
| `lawsuits.coverage.total`                   | `integer` |            |
| `lawsuits.coverage.distinctCases`           | `integer` |            |
| `lawsuits.coverage.discardedAsNonDisputant` | `integer` |            |
| `lawsuits.coverage.truncated`               | `boolean` |            |
| `lawsuits.coverage.inferenceRate`           | `number`  |            |

### `counters`

| Campo                              | Tipo      | Observação |
| ---------------------------------- | --------- | ---------- |
| `lawsuits.counters.total`          | `integer` |            |
| `lawsuits.counters.asActive`       | `integer` |            |
| `lawsuits.counters.asPassive`      | `integer` |            |
| `lawsuits.counters.criminal`       | `integer` |            |
| `lawsuits.counters.civil`          | `integer` |            |
| `lawsuits.counters.taxExecution`   | `integer` |            |
| `lawsuits.counters.labor`          | `integer` |            |
| `lawsuits.counters.administrative` | `integer` |            |
| `lawsuits.counters.sexualOffense`  | `integer` |            |
| `lawsuits.counters.drugs`          | `integer` |            |
| `lawsuits.counters.bankruptcy`     | `integer` |            |

### `windows`

| Campo                          | Tipo      | Observação |
| ------------------------------ | --------- | ---------- |
| `lawsuits.windows.last30Days`  | `integer` |            |
| `lawsuits.windows.last90Days`  | `integer` |            |
| `lawsuits.windows.last180Days` | `integer` |            |
| `lawsuits.windows.last365Days` | `integer` |            |

### `dimensions`

| Campo                 | Tipo                  | Observação |
| --------------------- | --------------------- | ---------- |
| `lawsuits.dimensions` | `map<string, object>` |            |

### `relationships`

| Campo                    | Tipo                  | Observação |
| ------------------------ | --------------------- | ---------- |
| `lawsuits.relationships` | `map<string, object>` |            |

### `indicators`

| Campo                 | Tipo                  | Observação |
| --------------------- | --------------------- | ---------- |
| `lawsuits.indicators` | `map<string, object>` |            |

### `items`

| Campo            | Tipo         | Observação |
| ---------------- | ------------ | ---------- |
| `lawsuits.items` | `array<any>` |            |

## Indicadores (`rules`)

| Campo                   | Tipo      | Observação                                                                                                                    |
| ----------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `rules[].evidence`      | `object`  | Os dados que sustentam o indicador, quando disparou.                                                                          |
| `rules[].fired`         | `boolean` | `true` quando o indicador se aplica aos dados.                                                                                |
| `rules[].magnitude`     | `number`  | Intensidade do achado, quando ele tem uma (ex.: uma contagem ou um valor).                                                    |
| `rules[].notApplicable` | `boolean` | `true` quando o indicador não pôde ser avaliado porque o dado que ele lê está ausente. Não é o mesmo que não disparar.        |
| `rules[].reason`        | `string`  | Por que o indicador não pôde ser avaliado (com `notApplicable`).                                                              |
| `rules[].rule`          | `string`  | `LAWSUITS_PERSON_HISTORY_INFERRED`, `LAWSUITS_PERSON_ONLY_AS_NON_DISPUTANT`, `LAWSUITS_PERSON_TRUNCATED` — Nome do indicador. |

Indicadores publicados por este dataset:

* `LAWSUITS_PERSON_HISTORY_INFERRED`
* `LAWSUITS_PERSON_ONLY_AS_NON_DISPUTANT`
* `LAWSUITS_PERSON_TRUNCATED`