Título Eleitoral e Local de Votação por CPF

GET https://app.fontedata.com/api/v1/consulta/tse-titulo-info
R$ 1,29 por consulta

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

Consulta dados de título de eleitor de cidadãos brasileiros. Retorna informações sobre o local de votação, seção eleitoral, zona eleitoral e situação da coleta biométrica do eleitor.

Este serviço é útil para validação e padronização de dados cadastrais em processos de onboarding, verificação de identidade e integração com fluxos de compliance e análise de risco. Permite automatizar decisões operacionais que dependem de informações oficiais sobre registro eleitoral, reduzindo erros manuais e aumentando a confiabilidade das validações.

Casos de uso:

  • Validação de dados pessoais durante onboarding de clientes e fornecedores
  • Integração com processos de compliance e análise de crédito
  • Automação de verificações documentais
  • Prevenção de inconsistências cadastrais

Benefícios:

  • Dados atualizados e confiáveis
  • Reduz necessidade de verificação manual
  • Aumenta precisão das validações
  • Implementação simples e escalável

Requisição

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

Parâmetros

NomeTipoDescriçãoExemplo
cpf obrigatórioCPFCPF do cidadão (11 dígitos). Único input — mãe e nascimento são enriquecidos.000.000.000-00

Resposta

A resposta contém os seguintes campos:

status — Resultado da consulta (sucesso ou erro).

identificacao — Dados de identificação do eleitor:

  • inscricao — Número de inscrição do título eleitoral
  • eleitor — Identificação do eleitor consultado

biometriaColetada — Booleano indicando se a biometria do eleitor foi coletada (true/false).

domicilioEleitoral — Informações do local de votação:

  • proximaEleicao — Data da próxima eleição
  • zona — Zona eleitoral do eleitor
  • secao — Seção eleitoral
  • local — Estabelecimento de votação
  • logradouro — Nome da rua, avenida ou via
  • numero — Número do endereço
  • bairro — Bairro do domicílio eleitoral
  • municipio — Município/cidade
  • uf — Unidade Federativa (estado)
Exemplo — 200 OK
{
  "status": "string",
  "nome_mae": "string",
  "identificacao": {
    "eleitor": "string",
    "inscricao": null
  },
  "data_nascimento": "string",
  "biometriaColetada": null,
  "domicilioEleitoral": {
    "uf": null,
    "zona": null,
    "local": null,
    "secao": null,
    "bairro": null,
    "numero": null,
    "municipio": null,
    "logradouro": null,
    "proximaEleicao": null
  }
}
Schema da resposta (JSON Schema)
JSON Schema
{
  "type": "object",
  "properties": {
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Mensagem de status da consulta."
    },
    "nome_mae": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da Mãe do Eleitor"
    },
    "identificacao": {
      "type": "object",
      "properties": {
        "eleitor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Identificação do eleitor."
        },
        "inscricao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Identificação do eleitor."
        }
      }
    },
    "data_nascimento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de Nascimento do Eleitor"
    },
    "biometriaColetada": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se a biometria foi coletada pelo eleitor."
    },
    "domicilioEleitoral": {
      "type": "object",
      "properties": {
        "uf": {
          "type": [
            "string",
            "null"
          ],
          "description": "Unidade federativa do domicílio eleitoral."
        },
        "zona": {
          "type": [
            "string",
            "null"
          ],
          "description": "Zona eleitoral."
        },
        "local": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local de votação."
        },
        "secao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Seção eleitoral."
        },
        "bairro": {
          "type": [
            "string",
            "null"
          ],
          "description": "Bairro do domicílio eleitoral."
        },
        "numero": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número do endereço do domicílio eleitoral."
        },
        "municipio": {
          "type": [
            "string",
            "null"
          ],
          "description": "Município do domicílio eleitoral."
        },
        "logradouro": {
          "type": [
            "string",
            "null"
          ],
          "description": "Logradouro do domicílio eleitoral."
        },
        "proximaEleicao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Data ou informação sobre a próxima eleição."
        }
      }
    }
  }
}

Códigos de erro

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

Observações

  • Cada requisição deve consultar apenas um eleitor.
  • A consulta não gera comprovantes automáticos.
  • Certifique-se de fornecer todos os parâmetros obrigatórios com informações corretas e completas.
  • Em caso de inconsistências ou dúvidas sobre o resultado, entre em contato com o suporte do gateway.

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.