💡 A API TSE - Situação Eleitoral permite consultar a situação eleitoral de um eleitor brasileiro na Justiça Eleitoral, fornecendo informações sobre a regularidade do título de eleitor e se a biometria foi coletada.
Introdução
A API TSE - Situação Eleitoral é ideal para uso em processos de onboarding de clientes, fornecedores e verificações fiscais, garantindo que informações eleitorais estejam regulares.
URL Base
A API está hospedada no seguinte endereço:
https://api.directd.com.br
Endpoint
GET /api/SituacaoEleitoral
Descrição: Endpoint para realizar consultas sobre a situação eleitoral de uma pessoa.
Nota: Não permite geração de comprovante.
Autenticação
- Obrigatório: É necessário fornecer um token de autenticação válido. Para suporte, entre em contato com suporte@directd.com.br.
Campos da API
Situação Eleitoral
- Identificação: Informações identificadoras do eleitor.
- Status: Status da situação eleitoral (Regular ou não).
- Flag Regular: Indica se a situação eleitoral está regular.
- 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. Caso informado, enviar também DATANASCIMENTO. |
| 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 | Não | Data de nascimento nos formatos dd/mm/aaaa ou dd-mm-aaaa. Necessário junto com NOME. |
| 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/SituacaoEleitoral?CPF=12345678909&TOKEN=seu_token_aqui'
Respostas
Sucesso (200)
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "TSE - Situação Eleitoral",
"consultaUid": "directd-987654",
"usuario": "Cliente",
"mensagem": "Sucesso",
"apiVersao": "v3",
"tempoExecucaoMs": 1200
},
"retorno": {
"identificacao": "JOÃO DA SILVA - CPF: 123.456.789-09",
"status": "Regular",
"isRegular": true,
"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 para realizar a consulta. |
| 404 | Não encontrado: registro não localizado. |
| 408 | Tempo esgotado: consulta não foi concluída no prazo. |
| 500 | Erro interno: falha no processamento da consulta. |
| 503 | Serviço em manutenção: indisponível temporariamente. |
10. Notas Importantes
- Certifique-se de fornecer ao menos um dos seguintes campos:
NOME + DATANASCIMENTO,CPFouNUMEROTITULOELEITORAL. - A consulta é limitada a um único eleitor por requisição.
- Biometria Coletada: A API informa se o eleitor já realizou a coleta biométrica.