API de consultaEm produção

Candidato ou não? O registro no TSE

Envie o CPF e receba do DivulgaCandContas do TSE os pedidos de registro de candidatura dessa pessoa: eleição, cargo, partido, número e situação do registro.

Acesso no mesmo dia, com crédito para testar · atualizado em 27 de outubro de 2026

  1. 1

    Entrada

    cpf
  2. 2

    Fonte oficial

    Tribunal Superior EleitoralDivulgação de Candidaturas e Contas Eleitorais

  3. 3

    Saída

    JSON

  4. CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Candidatura fictícia.

Parâmetros

  • cpfobrigatório

    O CPF de quem você quer checar.

Campos retornados

com_apontamentos
true quando a consulta encontrou algo que pede atenção (débito, processo, sanção).
certidao_emitida
Se o órgão emitiu o documento nesta consulta.
mensagem_orgao
A mensagem que o próprio portal devolveu, quando há.
documentos
Os documentos emitidos, um por item.
documentos[].com_apontamento
true quando este documento tem apontamento.
documentos[].dias_de_validade
Prazo de validade do documento, em dias.
documentos[].valida_ate
Data de validade, pronta para agendar a renovação.
documentos[].pdf_url
O documento emitido pelo órgão, guardado pela Hath.
documentos[].texto_completo
O texto integral do documento, extraído do PDF.
documentos[].total_registros
Quantos pedidos de candidatura a consulta encontrou.
documentos[].candidaturas
Um item por pedido de registro.
documentos[].candidaturas[].eleicao
Em qual eleição o pedido foi feito.
documentos[].candidaturas[].cargo
O cargo disputado.
documentos[].candidaturas[].partido
Sigla do partido.
documentos[].candidaturas[].numero
Número de urna.
documentos[].candidaturas[].situacao
Como está o registro: apto, indeferido, renúncia e outras.
documentos[].consultado_em
Data e hora da consulta.
Página inicial do DivulgaCandContas na Eleição Geral Federal 2026, com o quadro de pedidos de candidatura por cargo
RespostaJSON
{"com_apontamentos": true,"certidao_emitida": false,"mensagem_orgao": "1 pedido de registro de candidatura.","documentos": [{"com_apontamento": true,"dias_de_validade": null,"valida_ate": null,"pdf_url": null,"texto_completo": "Eleição Geral Federal 2026, Deputado …","total_registros": 1,"candidaturas": [{"eleicao": "Eleição Geral Federal 2026","cargo": "Deputado Estadual","partido": "SIGLA","numero": "00000","situacao": "Apto"}],"consultado_em": "2026-10-28T10:15:00"}]}

Como o resultado chega

A mesma estrutura em qualquer órgão: um status classificado e, quando a fonte emite, o PDF oficial. Só a consulta concluída é cobrada; tentativa sem resultado não entra na conta.

  • Regular

    verde

    Nada consta na fonte.

  • Atenção

    amarelo

    Há registro que não impede, como débito parcelado ou suspenso. Vale ler o documento.

  • Com apontamentos

    vermelho

    Consta débito, sanção ou processo. O documento vem junto.

  • Sem resposta

    cinza

    A fonte não respondeu, o captcha falhou ou ficou fora deste ciclo. Vira reprocessamento, nunca um "nada consta" falso.

A entrega sai em JSON, CSV, XLSX ou XML, por API REST, webhook ou direto no seu ERP. Portal que muda de layout, adiciona captcha ou troca de sistema é conta nossa: você paga pela entrega, não pelo conserto.

Como ler o resultado

Em 2026 o TSE recebeu 20.986 pedidos de candidatura na eleição geral, de presidente a deputado distrital. O DivulgaCandContas mostra todos os que pediram registro e é atualizado a cada 60 minutos durante o período eleitoral.

Para quem faz diligência de sócio, fornecedor ou cliente, o pedido de candidatura é um sinal de exposição política. Saber disso antes de fechar contrato evita surpresa em auditoria.

Perguntas frequentes

Mostra eleições anteriores?

O DivulgaCandContas guarda as eleições passadas; a API consulta pela eleição informada.

Precisa de login?

Não. É divulgação pública do TSE.

Traz as contas de campanha?

O portal tem as contas; esta consulta foca no registro da candidatura.

API Candidaturas (TSE DivulgaCand) na sua integração

Em produção. Acesso no mesmo dia, com crédito para testar.

Checar candidaturas em lote

A coleta é feita em fonte pública oficial: a Hath Data não é a fonte e não certifica o conteúdo publicado pelo órgão. O serviço é prestado sob contrato, o cliente é o controlador dos dados e declara a finalidade; a Hath atua como operadora. Nomes de órgãos são citados apenas para identificar a fonte, sem vínculo ou endosso. Veja os termos de uso e a política de privacidade.