# Consulta de Óbito

> Consulta óbito registrado para um CPF específico, viabilizando validação cadastral, prevenção de fraudes e análises de risco creditício.

- **Consulta:** `consulta-obito`
- **Categoria:** Pessoa Física
- **Preço:** R$ 0,43 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/consulta-obito`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/pessoa-fisica/consulta-obito

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint verifica se existe registro de óbito associado a um CPF específico no banco de dados de registros civis. Oferece uma solução essencial para validação cadastral e mitigação de riscos em diversos cenários:
>
> **Casos de uso:**
> - Onboarding de clientes e fornecedores, validando se a identidade informada corresponde a uma pessoa ativa
> - Prevenção de fraudes em abertura de contas e processos de cadastramento
> - Análise de risco e decisões de crédito baseadas em dados cadastrais precisos
> - Verificações de conformidade, identidade e cumprimento de políticas internas
> - Bloqueio de transações suspeitas relacionadas a pessoas falecidas
>
> **Benefícios:**
> - Informações atualizadas e validadas em tempo real
> - Reduz atrito no fluxo de aprovação sem comprometer segurança
> - Garante conformidade com regulamentações de proteção de dados
> - Minimiza riscos de fraude e roubo de identidade

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/consulta-obito?cpf=SEU_CPF"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/consulta-obito",
    params={"cpf": "SEU_CPF"},
    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/consulta-obito");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF"
}).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 (somente números, 11 dígitos) | formato: 000.000.000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A resposta contém os seguintes campos:
>
> | Campo | Tipo | Descrição |
> |-------|------|-----------|
> | cpf | string | CPF consultado |
> | nome | string | Nome registrado da pessoa |
> | constaObito | boolean | Indica se há registro de óbito para o CPF. Verdadeiro caso confirmado, falso caso contrário |
> | dataObito | string | Data do falecimento registrado (quando aplicável) |
> | anoObito | number | Ano do óbito (quando aplicável) |
> | status | string | Status do registro consultado, fornecendo contexto adicional sobre a informação retornada |

### Exemplo de resposta

```json
{
  "cpf": "string",
  "nome": "string",
  "status": "string",
  "anoObito": null,
  "dataObito": null,
  "constaObito": "boolean"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF do indivíduo consultado."
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do indivíduo ou registro."
    },
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Detalhes sobre o status do registro consultado."
    },
    "anoObito": {
      "type": [
        "number",
        "null"
      ],
      "description": "Ano de óbito do indivíduo, se constar."
    },
    "dataObito": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de óbito do indivíduo, se constar."
    },
    "constaObito": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Indica se consta óbito registrado para o CPF consultado."
    }
  }
}
```

## 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.
>
> - Este endpoint realiza uma consulta pontual e não gera comprovante ou documentação adicional do resultado
> - O resultado reflete o estado atual dos registros públicos de óbito disponíveis
> - A resposta é fornecida de forma síncrona, garantindo disponibilidade imediata do resultado
> - Para melhor aproveitamento do serviço em fluxos de high-volume, considere realizar as consultas em lotes, observando os limites de taxa de requisições aplicados ao seu plano
> - Em caso de dúvidas sobre a implementação ou interpretação dos resultados, consulte a documentação técnica completa do gateway ou contate o suporte

---

Página em HTML: https://fontedata.com/docs/pessoa-fisica/consulta-obito
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