> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nlbs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Datasets

> Catálogo dos datasets da API de dados

Todos os datasets usam a mesma rota, `POST /dados/consultar`. Cada página abaixo mostra a rota com o dataset já preenchido, o schema dos itens e exemplos com e sem dados. Para pedir vários datasets numa chamada, veja [Consulta combinada](https://docs.nlbs.ai/api-reference-dados/consultar.md).

| Dataset | Nome | Conteúdo |
| - | - | - |
| `pep` | [PEP](https://docs.nlbs.ai/dados/ref/pep.md) | Perfis de pessoa politicamente exposta. |
| `midia` | [Mídia](https://docs.nlbs.ai/dados/ref/midia.md) | Ocorrências de exposição em mídia. |
| `faccionados` | [Faccionados](https://docs.nlbs.ai/dados/ref/faccionados.md) | Avaliações de vínculo com facção. |
| `processos` | [Processos](https://docs.nlbs.ai/dados/ref/processos.md) | Processos judiciais, paginados por cursor. |
| `sancoes` | [Sanções](https://docs.nlbs.ai/dados/ref/sancoes.md) | Sanções, restrições, processos administrativos e listas de observação. |
| `vinculos` | [Vínculos societários](https://docs.nlbs.ai/dados/ref/vinculos.md) | Sócios do documento e participações dele em empresas. |
| `ubo` | [Beneficiário final (UBO)](https://docs.nlbs.ai/dados/ref/ubo.md) | Beneficiários finais da empresa. Só CNPJ. |
| `identidade` | [Identidade](https://docs.nlbs.ai/dados/ref/identidade.md) | Dados cadastrais da pessoa física. Só CPF. |
| `beneficios` | [Benefícios sociais](https://docs.nlbs.ai/dados/ref/beneficios.md) | Benefícios sociais federais recebidos, resumidos por programa. |

Dataset sem dado responde `encontrado: false` com `itens` vazio. Os itens são resumidos: texto longo (resumos de processo e de mídia) fica fora.

## pep

Veja [PEP](https://docs.nlbs.ai/dados/ref/pep.md).

## midia

Veja [Mídia](https://docs.nlbs.ai/dados/ref/midia.md).

## faccionados

Veja [Faccionados](https://docs.nlbs.ai/dados/ref/faccionados.md).

## processos

Veja [Processos](https://docs.nlbs.ai/dados/ref/processos.md). Os movimentos de um processo saem no [detalhe](#detalhe-de-um-processo).

## sancoes

Veja [Sanções](https://docs.nlbs.ai/dados/ref/sancoes.md).

## vinculos

Veja [Vínculos societários](https://docs.nlbs.ai/dados/ref/vinculos.md).

## ubo

Veja [Beneficiário final (UBO)](https://docs.nlbs.ai/dados/ref/ubo.md).

## identidade

Veja [Identidade](https://docs.nlbs.ai/dados/ref/identidade.md).

## beneficios

Veja [Benefícios sociais](https://docs.nlbs.ai/dados/ref/beneficios.md).

## Detalhe de um processo

`GET /dados/processos/{numero}` devolve um processo pelo número CNJ, com ou sem pontuação (20 dígitos). Exige o escopo `dados:processos`.

* Cabeçalho: `numero` (formatado), `titulo`, `classes` (lista de `codigo` e `nome` na TPU, a principal primeiro), `assuntos` (lista de `codigo` e `nome` na TPU), `tribunal` (`nome`, `cidade`, `uf`), `situacao`, `grau_atual`, `data_ajuizamento`, `data_distribuicao`, `ultima_movimentacao`, `valor_causa` (texto decimal) e `moeda`.
* `grau_atual` é a instância atual: `G1` (primeiro grau), `G2` (segundo grau), `SUP` (tribunal superior) ou `JE` (juizado especial).
* `partes`: até 100, com `total_partes`. Cada parte traz `nome`, `tipo` (`person` ou `organization`), `papel` e `papel_detalhe`.
* `movimentos`: uma página, da data mais recente para a mais antiga (sem data por último). `limite` de 1 a 100, padrão 20. Para a próxima página, repita a chamada com `cursor` igual ao `proximo_cursor` (valor opaco e assinado pelo servidor: não monte nem altere), que vem `null` na última. `total_movimentos` conta todos.
* Datas de calendário em `AAAA-MM-DD`; `publicado_em` em ISO 8601 UTC com `Z`.
* Número sem 20 dígitos responde `422` (`entrada_invalida`), número que não consta responde `404` (`nao_encontrado`) e cursor inválido (inclusive não emitido pela API) ou de outro processo responde `422` (`cursor_invalido`).

```bash theme={null}
curl "https://api.nlbs.ai/dados/processos/0000000-00.2024.8.26.0000?limite=20"   -H "X-API-Key: $NLLABS_API_KEY"
```

O exemplo de resposta está em [Detalhe de processo](https://docs.nlbs.ai/api-reference-dados/processo.md).

> [!NOTE]
>
> `faixa` (faccionados) é `T1`, `T2` ou `T3`; veja [Como ler a faixa](https://docs.nlbs.ai/dados/ref/faccionados.md). Os demais campos de enumeração (`tipo_pep`, `status`, `papel` e semelhantes) são texto livre no contrato: não dependa de uma lista fechada de valores.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.