# Título de Eleitor e Local de Votação

> Consulta a situação do título de eleitor e o local de votação de um cidadão a partir do CPF. Retorna a identificação do eleitor (nome e número de inscrição), a situação da regularidade eleitoral, se a biometria foi coletada, e o domicílio eleitoral completo: UF, município, zona, seção, bairro, logradouro e número. Informar nome da mãe e data de nascimento eleva a taxa de correspondência e desambigua homônimos.

- **Consulta:** `tse-titulo`
- **Categoria:** Eleitoral
- **Preço:** R$ 1,26 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/tse-titulo`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/eleitoral/tse-titulo

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> 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

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/tse-titulo?cpf=SEU_CPF&nome_mae=NOME_DA_MAE&data_nascimento=01%2F01%2F1990"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/tse-titulo",
    params={"cpf": "SEU_CPF", "nome_mae": "NOME_DA_MAE", "data_nascimento": "01/01/1990"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/tse-titulo");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF",
  "nome_mae": "NOME_DA_MAE",
  "data_nascimento": "01/01/1990"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | sim | CPF do cidadão (11 dígitos, com ou sem máscara). Obrigatório. | formato: 000.000.000-00 |
| `nome_mae` | texto | sim | Nome completo da mãe. Obrigatório — a base oficial exige nome da mãe e data de nascimento. Só tem o CPF? Use o endpoint tse-titulo-info (enriquece automaticamente). | formato: Nome completo da mãe |
| `data_nascimento` | texto | sim | Data de nascimento (DD/MM/AAAA). Obrigatório — a base oficial exige nome da mãe e data de nascimento. Só tem o CPF? Use tse-titulo-info. | `01/01/1990` |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> 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 de resposta

```json
{
  "status": "string",
  "identificacao": {
    "eleitor": "string",
    "inscricao": "string"
  },
  "biometriaColetada": null,
  "domicilioEleitoral": {
    "uf": "string",
    "zona": "number",
    "local": "string",
    "secao": "number",
    "bairro": "string",
    "numero": "string",
    "municipio": "string",
    "logradouro": "string",
    "proximaEleicao": null
  }
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Mensagem de status da consulta."
    },
    "identificacao": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "eleitor": {
          "type": [
            "string",
            "null"
          ],
          "description": "Identificação do eleitor."
        },
        "inscricao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número de inscrição do título eleitoral."
        }
      },
      "description": "Dados de identificação do eleitor."
    },
    "biometriaColetada": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se a biometria foi coletada pelo eleitor."
    },
    "domicilioEleitoral": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "uf": {
          "type": [
            "string",
            "null"
          ],
          "description": "Unidade federativa do domicílio eleitoral."
        },
        "zona": {
          "type": [
            "number",
            "null"
          ],
          "description": "Zona eleitoral."
        },
        "local": {
          "type": [
            "string",
            "null"
          ],
          "description": "Local de votação."
        },
        "secao": {
          "type": [
            "number",
            "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."
        }
      },
      "description": "Informações do domicílio eleitoral e local de votação."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `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. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - 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.

---

Página em HTML: https://fontedata.com/docs/eleitoral/tse-titulo
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp