Catálogo de APIs › Pessoa física

Origem múltipla

Óbito e Parentesco (herdeiros e sociedades)

Óbito do titular somado à rede familiar com CPF e grau de parentesco, e às sociedades em que ele figura.

Integração por API em construção. Esta consulta já roda hoje na plataforma, pela tela. O contrato abaixo é o que a API vai expor quando abrir.

Ficha

Estado medido agora, no mesmo lugar de onde a venda decide — não numa tabela mantida à parte.

Identificador
obito_parentescos
Preço
R$ 3,90
Aceita
CPF
Esfera
Federais
Procedência
Parceiro de integração
Na plataforma
Disponível

Parâmetros

O que a consulta exige para rodar. Parâmetro obrigatório que falta é recusado antes de qualquer cobrança — não vira consulta paga que volta vazia.

Parâmetro Obrigatório O que é
cpf Sim CPF do alvo, 11 dígitos.

Antes de integrar

Ressalvas sobre o que esta consulta é — e o que ela não é.

  • LGPD Dado sensível de terceiro: exige declaração de finalidade (LGPD).
  • Contém o óbito Responde o mesmo que a consulta de Óbito por CPF. Não é preciso comprar as duas para o mesmo consultado.
  • Indício O grau vem de base cadastral revendida. Quem prova filiação e sucessão é a certidão do registro civil.
  • Sem datas de sócio As sociedades vêm sem data de entrada e saída do sócio: para datar a saída, a consulta é a de Vínculos societários.

Códigos de retorno

A resposta HTTP é sempre 200; o resultado real está no campo code. A coluna de estorno faz parte do contrato: nem toda falha devolve o dinheiro, e você tem direito de saber quais antes de integrar.

Classe Códigos O que significa Estorna Retenta
sucesso 200 A origem respondeu e entregou.
nao_encontrado 612 A origem respondeu: nada consta para este alvo. Não Não
indeterminado 611 A origem não conseguiu emitir pela internet. Não é irregularidade. Não Não
erro_participante 608, 619, 620 A origem recusou os DADOS do pedido. Não Sim
retry 600, 605, 609, 610, 613, 614, 615, 618 Instabilidade momentânea da origem ou do transporte. Sim Sim
fatal 601, 602, 603, 604, 606, 607, 617, 621, 622 Defeito de integração — nosso, não seu. Sim Não

Permanentes: 602 e 603 não se curam sozinhos — a fonte sai do ar na hora e um humano é avisado.

Precisa desta consulta por API?

Diga qual volume você espera. A ordem de liberação segue a demanda real.

Falar sobre integração

‹ Voltar ao catálogo