Situação Eleitoral (TSE)

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/tse-situacao

R$ 0,43 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

Consulta a situação eleitoral de um eleitor brasileiro junto à Justiça Eleitoral, retornando informações sobre a regularidade do registro de votação e a coleta de biometria. Ideal para validar dados cadastrais, automatizar fluxos de decisão operacional e integrar verificações de conformidade em processos de onboarding, avaliação de risco e análise de crédito.

A consulta fornece indicadores claros sobre a situação regulatória do eleitor, permitindo decisões mais precisas e reduzindo erros manuais em processamentos em massa. É especialmente útil para organizações que precisam confirmar a regularidade eleitoral como parte de procedimentos internos.

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/tse-situacao?cpf=SEU_CPF"

Parâmetros

Nome	Tipo	Descrição	Exemplo
cpf obrigatório	CPF	CPF do cidadão (11 dígitos, com ou sem máscara). Único parâmetro.	000.000.000-00

Resposta

A resposta inclui os seguintes campos:

Campo	Tipo	Descrição
`identificacao`	string	Identificação do indivíduo consultado.
`status`	string	Descrição detalhada do status atual do registro eleitoral.
`isRegular`	boolean	Indica se o eleitor está com a situação eleitoral regular (`true`) ou não (`false`).
`biometriaColetada`	boolean	Indica se a biometria foi coletada (`true`) ou ainda não foi realizada (`false`).

Exemplo — 200 OK

{
  "status": "string",
  "isRegular": "boolean",
  "identificacao": "string",
  "biometriaColetada": "boolean"
}

Schema da resposta (JSON Schema)

JSON Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Detalhes sobre o status da inscrição eleitoral do eleitor."
    },
    "isRegular": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Indica se o eleitor está com situação eleitoral regular."
    },
    "identificacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF do eleitor consultado."
    },
    "biometriaColetada": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Indica se a biometria do eleitor foi coletada."
    }
  }
}

Códigos de erro

Código	Mensagem	Quando acontece
400	Requisição Inválida	a requisição está incorreta ou os parâmetros são inválidos.
401	Não Autenticado	o usuário não forneceu as credenciais corretas para acessar o recurso.
403	Não Autorizado	o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404	Não Encontrado	o servidor não encontrou uma representação atual do recurso solicitado.
408	Tempo Esgotado	o servidor não conseguiu retornar a requisição no prazo estabelecido.
500	Falha ao Realizar Consulta	o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503	Consulta em Manutenção	a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte.

Observações

Uma consulta por requisição: envie apenas um CPF por chamada à API.
Formatação flexível: o CPF pode ser enviado com ou sem caracteres de formatação; o sistema normaliza automaticamente.
Sem comprovantes: esta consulta retorna apenas informações de verificação, sem geração de documentos comprobatórios.
Integração com fluxos internos: utilize os campos isRegular e biometriaColetada para tomar decisões automáticas em pipelines de conformidade, onboarding de clientes e fornecedores, ou validação de dados cadastrais.
Casos de uso comuns: prevenção de autuações fiscais, verificação em processos de crédito, validação em fluxos de compliance, e padronização de bases de dados internas.

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.