Pular para o conteúdo principal

Listar processos por CPF ou CNPJ

GET 
/v1/processos

Retorna processos associados a um CPF ou CNPJ. Os filtros opcionais status, segredo_justica, tribunais, data_minima/data_maxima ou ano/mes reduzem o portfólio antes da cobrança; intervalos ainda maiores que o limite síncrono retornam FILTER_RANGE_TOO_BROAD sem reservar créditos. Quando tribunais é informado, aceita até cinco siglas e cobra R$ 0,25 por tribunal que efetivamente retornar ao menos um processo. Siglas sem resultado não são cobradas e as páginas seguintes da mesma consulta são incluídas. Sem o filtro tribunais, o preço padrão da listagem permanece inalterado. Para paginação por cursor, siga o link next retornado, que preserva os filtros, em vez de reconstruir a URL manualmente.

Valor para a operação: transforma CPF ou CNPJ em uma porta de entrada para triagem, due diligence, enriquecimento cadastral e seleção dos casos que merecem aprofundamento.

Autenticação e resposta: envie a chave em x-api-key ou Authorization: Bearer. Os exemplos mostram uma resposta típica; campos adicionais podem aparecer conforme o tipo de consulta. meta pode conter creditsCharged, creditsRemaining, requestId e searchLogId. Trate erros pelo status HTTP e por error.code.

SLA e HTTP 202: a API reserva uma janela total de até 30 segundos para responder. Quando uma consulta elegível não termina com segurança nessa janela, o trabalho continua no servidor e a resposta é HTTP 202, sem débito adicional naquele estado pendente. Siga o header Location ou data.statusUrl com a mesma API key; Retry-After, pollAfterSeconds, pollAfterMs e nextPollAt informam quando tentar novamente. Pare o polling quando receber um status diferente de 202. A URL de status reproduz a resposta final sem executar nem cobrar a operação novamente.

Requisição​

Responses​

Resposta da operação.