Formato
Requisições com corpo e respostas usam JSON (Content-Type: application/json). As duas APIs são servidas em https://api.nlbs.ai, sem prefixo de caminho.
Datas
- API de Dados: data de calendário em
AAAA-MM-DDe instante em ISO 8601 UTC terminando emZ(por exemplo,2026-01-15T12:00:00Z). - API de Anti Fraude: o formato de cada campo de data está descrito na referência da rota.
Paginação
As respostas são resumidas e paginadas, nunca um resultado gigante de uma vez.- API de Dados: cursor opaco. Repita a chamada com o
proximo_cursorrecebido até ele virnull. O cursor é emitido pela API: não monte nem altere.limitevai de 1 a 100. - API de Anti Fraude: as listagens usam
limiteoffsetoucursor, conforme a rota. Veja a referência de cada uma.
Idempotência
POST /dados/consultar e GET /dados/processos/{numero} aceitam o cabeçalho opcional Idempotency-Key. A mesma chave, em 24 horas a partir da primeira chamada, devolve a mesma resposta sem repetir a leitura.
Mascaramento de documentos
CPF e CNPJ de terceiros vêm mascarados nas respostas, e o nome vem inteiro. EmGET /entities (API de Anti Fraude), os identificadores vêm sempre mascarados. Na API de Dados, o documento da entidade consultada não é mascarado. Veja o detalhe em API de Dados.
