curl --request POST \
--url https://api.nlbs.ai/dados/consultar \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"datasets": [],
"documento": "<string>",
"processos": {
"cursor": "<string>",
"limite": 25
}
}
'import requests
url = "https://api.nlbs.ai/dados/consultar"
payload = {
"datasets": [],
"documento": "<string>",
"processos": {
"cursor": "<string>",
"limite": 25
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
datasets: [],
documento: '<string>',
processos: {cursor: '<string>', limite: 25}
})
};
fetch('https://api.nlbs.ai/dados/consultar', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nlbs.ai/dados/consultar",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'datasets' => [
],
'documento' => '<string>',
'processos' => [
'cursor' => '<string>',
'limite' => 25
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.nlbs.ai/dados/consultar"
payload := strings.NewReader("{\n \"datasets\": [],\n \"documento\": \"<string>\",\n \"processos\": {\n \"cursor\": \"<string>\",\n \"limite\": 25\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.nlbs.ai/dados/consultar")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"datasets\": [],\n \"documento\": \"<string>\",\n \"processos\": {\n \"cursor\": \"<string>\",\n \"limite\": 25\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nlbs.ai/dados/consultar")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"datasets\": [],\n \"documento\": \"<string>\",\n \"processos\": {\n \"cursor\": \"<string>\",\n \"limite\": 25\n }\n}"
response = http.request(request)
puts response.read_body{
"consultado_em": "2026-01-15T12:00:00Z",
"datasets": {
"faccionados": {
"encontrado": true,
"itens": [
{
"documento": "***.982.***-**",
"faixa": "T1",
"nome": "Beltrano de Tal",
"numero_processo": "0001234-56.2020.8.26.0100",
"organizacao": "Organizacao Exemplo"
}
]
},
"midia": {
"encontrado": true,
"itens": [
{
"categoria": "exemplo",
"data": "2025-06-20",
"dominios": [
"exemplo.com.br"
],
"fase": "exemplo",
"tema": "exemplo",
"titulo": "Titulo sintetico",
"url": "https://exemplo.com.br/noticia",
"veiculo": "Veiculo Exemplo"
}
]
},
"pep": {
"encontrado": true,
"itens": [
{
"cargo": "Prefeito",
"descricao": "Descricao sintetica.",
"inicio": "2021-01-01",
"instituicao": "Prefeitura Exemplo",
"status_pep": "active",
"tipo_pep": "elected_official",
"tipo_perfil": "politico"
}
]
},
"processos": {
"encontrado": true,
"itens": [
{
"assuntos": [
{
"codigo": "7691",
"nome": "Obrigacoes"
}
],
"classes": [
{
"codigo": "7",
"nome": "Procedimento Comum Civel"
}
],
"data_ajuizamento": "2024-03-10",
"data_distribuicao": "2024-03-11",
"moeda": "BRL",
"numero": "0000000-00.2024.8.26.0000",
"papel": "reu",
"partes": [
{
"consultada": true,
"nome": "Fulano de Tal",
"papel": "reu"
},
{
"consultada": false,
"nome": "Beltrano de Tal",
"papel": "autor"
}
],
"status": "ativo",
"tipo": "civel",
"tribunal": {
"cidade": "Cidade",
"nome": "Tribunal Exemplo",
"uf": "SP"
},
"ultima_movimentacao": "2025-11-02",
"valor": "10000.00"
}
],
"total": 1
}
},
"documento": "12345678909",
"encontrado": true,
"tipo": "cpf"
}{
"erro": {
"codigo": "<string>",
"mensagem": "<string>"
}
}{
"erro": {
"codigo": "<string>",
"mensagem": "<string>"
}
}{
"erro": {
"codigo": "<string>",
"mensagem": "<string>"
}
}{
"erro": {
"codigo": "<string>",
"mensagem": "<string>"
}
}{
"erro": {
"codigo": "<string>",
"mensagem": "<string>"
}
}Consulta de dados por documento
Consulta os dados de um CPF ou CNPJ em um ou mais datasets (pep, processos, faccionados, midia, sancoes, vinculos, ubo, identidade, beneficios). Retorna, por dataset, encontrado e os itens resumidos, com documento de terceiros mascarado; processos traz tambem total e proximo_cursor. Envie documento e a lista datasets; so os datasets pedidos voltam na resposta. Dataset sem dado responde vazio (encontrado=false). Para paginar processos, repita a chamada com processos.cursor igual ao proximo_cursor recebido. Cursor invalido, adulterado ou de outro documento responde 422 (cursor_invalido). O dataset ubo exige CNPJ: com CPF responde 422 (ubo_exige_cnpj). O dataset identidade exige CPF: com CNPJ responde 422 (identidade_exige_cpf). O dataset beneficios exige CPF: com CNPJ responde 422 (beneficios_exige_cpf).
curl --request POST \
--url https://api.nlbs.ai/dados/consultar \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"datasets": [],
"documento": "<string>",
"processos": {
"cursor": "<string>",
"limite": 25
}
}
'import requests
url = "https://api.nlbs.ai/dados/consultar"
payload = {
"datasets": [],
"documento": "<string>",
"processos": {
"cursor": "<string>",
"limite": 25
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
datasets: [],
documento: '<string>',
processos: {cursor: '<string>', limite: 25}
})
};
fetch('https://api.nlbs.ai/dados/consultar', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.nlbs.ai/dados/consultar",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'datasets' => [
],
'documento' => '<string>',
'processos' => [
'cursor' => '<string>',
'limite' => 25
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.nlbs.ai/dados/consultar"
payload := strings.NewReader("{\n \"datasets\": [],\n \"documento\": \"<string>\",\n \"processos\": {\n \"cursor\": \"<string>\",\n \"limite\": 25\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.nlbs.ai/dados/consultar")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"datasets\": [],\n \"documento\": \"<string>\",\n \"processos\": {\n \"cursor\": \"<string>\",\n \"limite\": 25\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nlbs.ai/dados/consultar")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"datasets\": [],\n \"documento\": \"<string>\",\n \"processos\": {\n \"cursor\": \"<string>\",\n \"limite\": 25\n }\n}"
response = http.request(request)
puts response.read_body{
"consultado_em": "2026-01-15T12:00:00Z",
"datasets": {
"faccionados": {
"encontrado": true,
"itens": [
{
"documento": "***.982.***-**",
"faixa": "T1",
"nome": "Beltrano de Tal",
"numero_processo": "0001234-56.2020.8.26.0100",
"organizacao": "Organizacao Exemplo"
}
]
},
"midia": {
"encontrado": true,
"itens": [
{
"categoria": "exemplo",
"data": "2025-06-20",
"dominios": [
"exemplo.com.br"
],
"fase": "exemplo",
"tema": "exemplo",
"titulo": "Titulo sintetico",
"url": "https://exemplo.com.br/noticia",
"veiculo": "Veiculo Exemplo"
}
]
},
"pep": {
"encontrado": true,
"itens": [
{
"cargo": "Prefeito",
"descricao": "Descricao sintetica.",
"inicio": "2021-01-01",
"instituicao": "Prefeitura Exemplo",
"status_pep": "active",
"tipo_pep": "elected_official",
"tipo_perfil": "politico"
}
]
},
"processos": {
"encontrado": true,
"itens": [
{
"assuntos": [
{
"codigo": "7691",
"nome": "Obrigacoes"
}
],
"classes": [
{
"codigo": "7",
"nome": "Procedimento Comum Civel"
}
],
"data_ajuizamento": "2024-03-10",
"data_distribuicao": "2024-03-11",
"moeda": "BRL",
"numero": "0000000-00.2024.8.26.0000",
"papel": "reu",
"partes": [
{
"consultada": true,
"nome": "Fulano de Tal",
"papel": "reu"
},
{
"consultada": false,
"nome": "Beltrano de Tal",
"papel": "autor"
}
],
"status": "ativo",
"tipo": "civel",
"tribunal": {
"cidade": "Cidade",
"nome": "Tribunal Exemplo",
"uf": "SP"
},
"ultima_movimentacao": "2025-11-02",
"valor": "10000.00"
}
],
"total": 1
}
},
"documento": "12345678909",
"encontrado": true,
"tipo": "cpf"
}{
"erro": {
"codigo": "<string>",
"mensagem": "<string>"
}
}{
"erro": {
"codigo": "<string>",
"mensagem": "<string>"
}
}{
"erro": {
"codigo": "<string>",
"mensagem": "<string>"
}
}{
"erro": {
"codigo": "<string>",
"mensagem": "<string>"
}
}{
"erro": {
"codigo": "<string>",
"mensagem": "<string>"
}
}Headers
Body
Response
Um bloco por dataset pedido.

