Skip to main content
POST
Consultar Beneficiário final (UBO)
Beneficiários finais da empresa consultada. Retorna até 50 beneficiários, com percentual, tipo de controle e profundidade na cadeia; documento sempre mascarado. Só existe para CNPJ: com CPF responde 422 (ubo_exige_cnpj). A chave precisa do escopo dados:ubo.

Authorizations

X-API-Key
string
header
required

Headers

Idempotency-Key
string | null

Opcional. Mesma chave em 24 h a partir da primeira chamada devolve a mesma resposta, sem repetir a leitura.

Required string length: 1 - 255
Pattern: ^[A-Za-z0-9._\-]+$

Body

application/json
datasets
enum<string>[]
required

Sempre ["ubo"] nesta página.

Required array length: 1 element
Available options:
ubo
documento
string
required

CPF ou CNPJ, com ou sem pontuacao.

Response

Um bloco por dataset pedido.

consultado_em
string<date-time>
required

Instante da consulta, ISO 8601 em UTC (sufixo Z).

Example:

"2026-01-15T12:00:00Z"

datasets
Datasets · object
required
documento
string
required
encontrado
boolean
required
tipo
enum<string>
required
Available options:
cpf,
cnpj