Dados cadastrais

Beneficiário Final (UBO) - CPF

Identifica os beneficiários finais da pessoa física consultada, percorrendo até 10 níveis de sociedades ligadas e coligadas.

Falar com o comercial Ver o catálogo

Quando usar

Descrição

O serviço Beneficiário Final (UBO) analisa a cadeia societária da pessoa física consultada, com até 10 graus de empresas ligadas e coligadas, para identificar as pessoas físicas que estão no final da estrutura.

São apresentados as sociedades e os sócios de cada nível, a situação (ativo ou inativo), a indicação de PEP e o histórico de cargos com as datas de início e fim, além da lista consolidada de beneficiários finais.

Casos de uso

Identificação de beneficiário final exigida pela regulação de PLD/FT, due diligence de clientes e fornecedores e análise de grupo econômico.

Requisição

Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.

POST /api/v1/{tenant}/pessoas/beneficiario-final-ubo-cpf

Campo	Obrigatório	Descrição
`document`	sim	CPF da pessoa, com ou sem máscara.

{
  "document": "000.000.000-00"
}

Campos de retorno

Campos dentro de data. [] indica lista.

Campo	Tipo
`documentoConsultado`	texto
`nomeRazaoSocial`	texto
`dataCadastro`	texto
`dataUpdate`	texto
`pepMatriz`	booleano
`sociedades[].documento`	texto
`sociedades[].nomeRazaoSocial`	texto
`sociedades[].pepMatriz`	booleano
`sociedades[].status`	booleano
`sociedades[].nivel`	número
`sociedades[].socios[].documento`	texto
`sociedades[].socios[].nomeRazaoSocial`	texto
`sociedades[].socios[].pepMatriz`	booleano
`sociedades[].socios[].status`	booleano
`sociedades[].socios[].nivel`	número
`sociedades[].socios[].socios`	texto
`sociedades[].socios[].historicoSociedades[].dataInicio`	texto
`sociedades[].socios[].historicoSociedades[].dataFim`	texto
`sociedades[].socios[].historicoSociedades[].status`	booleano
`sociedades[].socios[].historicoSociedades[].cargo`	texto
`sociedades[].historicoSociedades[].dataInicio`	texto
`sociedades[].historicoSociedades[].dataFim`	texto
`sociedades[].historicoSociedades[].status`	booleano
`sociedades[].historicoSociedades[].cargo`	texto
`quantidade_sociedades`	número
`quantidade_sociedades_ativas`	número
`quantidade_pessoas_fisicas_diretas`	número
`pep_consultado`	texto
`possui_pep_na_estrutura`	booleano
`beneficiarios_finais[].documento`	texto
`beneficiarios_finais[].nome`	texto
`beneficiarios_finais[].pep`	booleano
`beneficiarios_finais[].nivel`	número
`quantidade_beneficiarios_finais`	número

Exemplo de resposta

Estrutura real da resposta, com valores fictícios.

{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Beneficiário Final (UBO) - CPF",
  "query_slug": "beneficiario-final-ubo-cpf",
  "data": {
    "documentoConsultado": "texto",
    "nomeRazaoSocial": "texto",
    "dataCadastro": "texto",
    "dataUpdate": "texto",
    "pepMatriz": false,
    "sociedades": [
      {
        "documento": "texto",
        "nomeRazaoSocial": "texto",
        "pepMatriz": false,
        "status": false,
        "nivel": 0,
        "socios": [
          {
            "documento": "texto",
            "nomeRazaoSocial": "texto",
            "pepMatriz": false,
            "status": false,
            "nivel": 0,
            "socios": null,
            "historicoSociedades": [
              {
                "dataInicio": "texto",
                "dataFim": null,
                "status": false,
                "cargo": "texto"
              }
            ]
          }
        ],
        "historicoSociedades": [
          {
            "dataInicio": "texto",
            "dataFim": null,
            "status": false,
            "cargo": "texto"
          }
        ]
      }
    ],
    "quantidade_sociedades": 0,
    "quantidade_sociedades_ativas": 0,
    "quantidade_pessoas_fisicas_diretas": 0,
    "pep_consultado": null,
    "possui_pep_na_estrutura": false,
    "beneficiarios_finais": [
      {
        "documento": "texto",
        "nome": "texto",
        "pep": false,
        "nivel": 0
      }
    ],
    "quantidade_beneficiarios_finais": 0
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "5.000"
}

Cobrança e respostas

O valor é cobrado por consulta bem-sucedida.
200 — consulta processada (veja status no corpo da resposta)
401 — token ausente, inválido, inativo ou expirado
403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
429 — limite de requisições por minuto da chave excedido
504 — tempo máximo de execução do serviço excedido