Pular para o conteúdo principal

Listar o acervo de precatórios

GET 
/v1/precatorios

Catálogo unificado para análise de precatórios. Sem ano_orcamentario, lista diretamente processos da classe Precatório no índice processual oficial e não exige vínculo orçamentário. Sem UF/tribunal e com ordenar=analise_desc, coloca primeiro os registros com CNJ, CPF/CNPJ do credor, CNPJ do devedor, ano orçamentário, situação de pagamento analisada e valor; os registros parciais continuam nas páginas seguintes. Com ano_orcamentario ou ano_orcamentario_inicio/fim, sem recorte estadual ou com tribunal federal como TRF1, lista o orçamento federal em mode=PRECATORIO_BUDGET, inclusive registros sem CNJ. Com TJ/TRE ou somente UF, consulta o índice processual enriquecido pelas listas do tribunal em mode=PRECATORIO_PROCESS_INDEX. Vínculos seguros acrescentam processo, partes, publicações e situação individual. Permite filtrar por CNJ, tribunal, UF, parte, espécie, ente devedor, valor, situação, risco, completude e datas. meta.search.mode informa a base selecionada, meta.search.prioritization informa a estratégia aplicada e meta.search.coverage informa o avanço do índice processual. Ano orçamentário não comprova pagamento e parte do processo não equivale automaticamente ao beneficiário final.

Valor para a operação: oferece uma listagem única do acervo processual e de todo o orçamento de cada exercício, enriquecida com partes, documentos, valores e vínculos auditáveis.

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.