> ## 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.

# Erros da API de dados

> Códigos e formato de erro da API de dados

Diferente da API de Anti Fraude, a API de Dados devolve erros neste formato:

```json theme={null}
{ "erro": { "codigo": "entrada_invalida", "mensagem": "Entrada invalida nos campos: documento." } }
```

A mensagem de `422` cita só os campos com problema e nunca repete o valor enviado, porque o documento é dado pessoal.

| Status | `erro.codigo` | Quando |
| - | - | - |
| `422` | `entrada_invalida` | Documento inválido, dataset desconhecido ou repetido, campo extra, `limite` fora de 1 a 100. No detalhe de processo, número sem 20 dígitos. |
| `422` | `cursor_invalido` | `processos.cursor` inválido ou de outro documento, ou `cursor` do detalhe inválido ou de outro processo. |
| `401` | `chave_invalida` | Chave ausente ou inválida. |
| `403` | `escopo_insuficiente` | A chave não tem `dados:consultar` ou o escopo de um dataset pedido (`dados:pep`, ...). No detalhe de processo, falta `dados:processos`. |
| `404` | `nao_encontrado` | Detalhe de processo: número que não consta. |
| `403` | `no_plan_assigned` | A empresa não tem acesso à API de dados. |
| `429` | motivo da cota | Limite de uso atingido. |
| `503` | `indisponivel` | Falha temporária na leitura. Repita a consulta. |

> [!NOTE]
>
> Documento válido sem dados em um dataset não é erro: a resposta é `200` com `encontrado: false` e `itens` vazio.


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