O endpoint /api/TseCertidaoQuitacaoEleitoral permite consultar a situação eleitoral de uma pessoa física, comprovando se está quite com a Justiça Eleitoral até a data da emissão.
TSE - Certidão de Quitação Eleitoral
A Certidão de Quitação Eleitoral comprova que a eleitora ou o eleitor está quite com a Justiça Eleitoral (JE) até a data de sua emissão.
Casos de Uso
- Onboarding de Clientes e Fornecedores
- Processos de compliance e integridade
- Verificação de regularidade eleitoral para posse em cargos públicos
- Análises cadastrais e validação de identidade
- Processos admissionais e exigências legais
Aplicações
- Prevenção de Autuações Fiscais
- Onboarding de Clientes e Fornecedores
Benefícios
- Consulta automatizada da situação eleitoral junto à Justiça Eleitoral.
- Verificação rápida da regularidade do eleitor.
- Redução de fraudes cadastrais.
- Integração simples com sistemas internos de cadastro e compliance.
- Possibilidade de geração de comprovante em PDF.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/TSECertidaodeQuitacaoEleitoralEndpoint
GET https://apiv3.directd.com.br/api/TSECertidaodeQuitacaoEleitoral?Nome={0}&CPF={1}&NOMEMAE={2}&NOMEPAI={3}&NUMEROTITULOELEITORAL={4}&DATANASCIMENTO={5}&Token=Seu_TokenDescrição: Endpoint para realizar consultas TSE - Certidão de Quitação Eleitoral.
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- Data de Nascimento: Data de nascimento do indivíduo
- Documento Consultado: Documento consultado referente ao CPF/CNPJ
- Domicílio Desde: Informa desde quando o indivíduo está com o atual domicílio.
- Filiação: Informa a filiação do indivíduo.
- Flag Regular: Informa se o indivíduo está ou não com a situação eleitoral regular. True(verdadeiro) ou false(falso)
- Inscrição: Retorna a inscrição do documento consultado
- Município: Município/cidade referente ao registro
- Nome: Nome do indivíduo/registro
- Ocupação Declarada: Informa a ocupação declarada do indivíduo.
- Seção: Seção do CNAE
- Status: Retorna detalhes sobre o status do registro em questão
- UF: Unidade Federativa (estado) referente ao registro
- Zona: Zona eleitoral do indivíduo consultado
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
DATANASCIMENTO | string | Sim | O parâmetro DATANASCIMENTO deve ser fornecido, com ou sem formatação. |
NUMEROTITULOELEITORAL | string | Sim | O parâmetro NUMEROTITULOELEITORAL pode ser enviado com ou sem formatação. |
NOMEPAI | string | Sim | O parâmetro NOMEPAI pode ser enviado com qualquer outro. |
NOMEMAE | string | Sim | O parâmetro NOMEMAE pode ser enviado com qualquer outro. |
CPF | string | Sim | O parâmetro CPF pode ser enviado com ou sem formatação. |
NOME | string | Sim | O parâmetro NOMEPAI pode ser enviado com qualquer outro. |
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": {
"nome": "string",
"documentoConsultado": "string",
"inscricao": "string",
"municipio": "string",
"dataNascimento": "string",
"filiacao": "string",
"zona": "string",
"secao": "string",
"uf": "string",
"domicilioDesde": "string",
"ocupacaoDeclarada": "string",
"isRegular": true,
"status": "string"
}
}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