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

A API TSE - Título e Local de Votação 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.

💡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.

Introdução

A API TSE - Título e Local de Votação é uma solução ideal para verificações cadastrais, onboarding de clientes e fornecedores, além de outras aplicações que requerem a validação de dados eleitorais.

URL Base

https://api.directd.com.br

Endpoint

GET /api/TituloLocalVotacao

Descrição: Endpoint para consulta de informações sobre o título de eleitor e local de votação.

Nota: Não permite geração de comprovante.

Autenticação

Obrigatório: Um token válido é necessário para autenticar as requisições. Para suporte, entre em contato com suporte@directd.com.br.

Campos da API

Identificação

Inscrição: Número do título de eleitor.
Eleitor: Nome do eleitor.

Domicílio Eleitoral

Próxima Eleição: Data da próxima eleição.
Zona: Zona eleitoral.
Seção: Seção eleitoral.
Local: Nome do local de votação.
Logradouro: Rua/avenida do local de votação.
Número: Número do local de votação.
Bairro: Bairro do local de votação.
Município: Cidade do local de votação.
UF: Unidade Federativa do local de votação.

Biometria

Flag Biometria Coletada: Indica se a biometria foi coletada.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
NOME	string	Não	Nome completo do eleitor.
CPF	string	Não	CPF do eleitor, com ou sem formatação.
NUMEROTITULOELEITORAL	string	Não	Número do título de eleitor, com ou sem formatação.
DATANASCIMENTO	string	Sim	Data de nascimento do eleitor nos formatos `dd/mm/aaaa` ou `dd-mm-aaaa`.
NOMEMAE	string	Sim	Nome completo da mãe do eleitor.
TOKEN	string	Sim	Token de autenticação necessário para acessar a API.

Exemplos de Requisição

Usando cURL

curl 'https://api.directd.com.br/api/TituloLocalVotacao?CPF=12345678909&DATANASCIMENTO=01/01/1980&NOMEMAE=MARIA+DA+SILVA&TOKEN=seu_token_aqui'

Respostas

Sucesso (200)

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "TSE - Título e Local de Votação",
    "consultaUid": "directd-87654321",
    "usuario": "Cliente",
    "mensagem": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 1500
  },
  "retorno": {
    "identificacao": {
      "inscricao": "123456789012",
      "eleitor": "JOÃO DA SILVA"
    },
    "domicilioEleitoral": {
      "proximaEleicao": "2024-10-15",
      "zona": 45,
      "secao": 123,
      "local": "ESCOLA MUNICIPAL JOÃO PESSOA",
      "logradouro": "RUA DAS LARANJEIRAS",
      "numero": "123",
      "bairro": "CENTRO",
      "municipio": "SÃO PAULO",
      "uf": "SP"
    },
    "biometriaColetada": true}
}

9. Erros Comuns

Código	Descrição
400	Requisição inválida: parâmetros incorretos.
401	Não autenticado: token inválido ou ausente.
403	Não autorizado: saldo insuficiente.
404	Recurso solicitado não encontrado.
500	Erro interno: falha no processamento da consulta.

10. Notas Importantes

Certifique-se de fornecer os campos obrigatórios: DATANASCIMENTO e NOMEMAE, combinados com NOME, CPF ou `NUM

Orientações e respostas da equipe da Direct Data