TSE - Título e Local de Votação

Consulta para obter dados relacionados ao título de eleitor e local de votação do usuário.

Casos de Uso

Integração com TSE - Título e Local de Votação
Validação e padronização de dados cadastrais
Automação de consultas para decisões operacionais
Integração com fluxos de risco, crédito e compliance

Aplicações

Prevenção de Autuações Fiscais
Onboarding de Clientes e Fornecedores

Benefícios

Documentação de TSE - Título e Local de Votação acessível e atualizada
Reduz custos e erros manuais
Aumenta confiabilidade das decisões
Integração simples e escalável

Esta API permite obter informações relacionadas ao título de eleitor de um cidadão brasileiro, incluindo o local de votação, seção, zona eleitoral e o status de coleta biométrica.

URL Base

A API está hospedada no seguinte endereço:

https://apiv3.directd.com.br/api/TituloLocalVotacao

Endpoint

GET https://apiv3.directd.com.br/api/TituloLocalVotacao?Nome={0}&CPF={1}&NumeroTituloEleitoral={2}&DataNascimento={3}&NomeMae={4}&Token=Seu_Token

Descrição: Endpoint para realizar consultas TSE - Título e Local de Votação.

Nota: Esta consulta não gera comprovantes.

Campos Retornados

Bairro: Bairro do endereço
Domicílio Eleitoral: Retorna os dados do local de votação do eleitor consultado
Eleitor: Retorna a identificação do eleitor consultado
Flag Biometria Coletada: Informa se o eleitor teve a biometria coletada. True(verdadeiro) ou false(falso)
Identificação: Identificação do indivíduo consultado
Inscrição: Retorna a inscrição do documento consultado
Local: Local onde se situa o registro
Logradouro: Nome da rua, avenida, travessa, alameda ou outros onde está localizado o endereço.
Município: Município/cidade referente ao registro
Número: Número do registro em questão
Próxima Eleição: Informação a respeito da próxima votação
Seção: Seção do CNAE
UF: Unidade Federativa (estado) referente ao registro
Zona: Zona eleitoral do indivíduo consultado

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`NOMEMAE`	string	Sim	O parâmetro NOMEMAE deve ser enviado de forma completa.
`DATANASCIMENTO`	string	Sim	O parâmetro DATANASCIMENTO deve ser enviado nestes formatos: dd/mm/aaaa ou dd-mm-aaaa.
`NUMEROTITULOELEITORAL`	string	Sim	O parâmetro NUMEROTITULOELEITORAL pode ser enviado com ou sem formatação.
`CPF`	string	Sim	O parâmetro CPF pode ser enviado com ou sem formatação.
`NOME`	string	Sim	O parâmetro NOMEMAE deve ser enviado de forma completa.
`TOKEN`	string	Sim	O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "string",
    "consultaUid": "string",
    "chave": "string",
    "usuario": "string",
    "mensagem": "string",
    "ip": "string",
    "resultadoId": 0,
    "resultado": "string",
    "apiVersao": "v3",
    "enviarCallback": false,
    "gerarComprovante": false,
    "urlComprovante": "string",
    "assincrono": true,
    "data": "dd/MM/yyyy HH:mm:ss",
    "tempoExecucaoMs": 0
  },
  "retorno": {
    "identificacao": {
      "inscricao": "string",
      "eleitor": "string"
    },
    "domicilioEleitoral": {
      "proximaEleicao": "string",
      "zona": 0,
      "secao": 0,
      "local": "string",
      "logradouro": "string",
      "numero": "string",
      "bairro": "string",
      "municipio": "string",
      "uf": "string"
    },
    "biometriaColetada": true
  }
}

Erros Comuns

Código	Descrição
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.

Notas Importantes

Informe apenas um único documento por requisição
Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228