Skip to main content
POST
/
onboarding
/
api
/
v1
/
know
/
business
Iniciar Consulta KYB
curl --request POST \
  --url https://api-hml.valid.com/onboarding/api/v1/know/business \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "cnpj": "<string>",
  "webhookUrl": "<string>",
  "webhookBasicAuth": "<string>",
  "datasets": [
    "<string>"
  ],
  "datasetPackageId": "<string>",
  "refreshData": true
}
'
{
  "requestId": "<string>",
  "createdAt": "<string>"
}

​
Request Body

​
cnpj
string
required
CNPJ da empresa a ser consultada (apenas números)Exemplo: 12345678000100
​
webhookUrl
string
URL que receberá os resultados quando o processamento for concluídoFormato: URIExemplo: https://seusistema.com/webhook
​
webhookBasicAuth
string
default:""
Autenticação básica para o webhook (username:password ou base64(‘username:password’))Exemplo: usuario:senha
​
datasets
string[]
Datasets a serem consultados (cada elemento é um valor do enum de datasets PJ, ex.: basic, kyc, addresses).Exemplo: ["basic", "kyc", "addresses"]
​
datasetPackageId
string
default:""
ID do pacote de datasetsFormato: UUIDExemplo: 05be75cc-8f8a-414a-891f-434aa9b4e7a5
​
refreshData
boolean
Forçar atualização dos dadosExemplo: false

​
Response

​
requestId
string
Identificador único da requisiçãoExemplo: 05be75cc-8f8a-414a-891f-434aa9b4e7a5
​
createdAt
string
Data e hora de criação da requisiçãoExemplo: 2023-01-01T12:00:00

​
Webhook Content

O conteúdo será enviado ao webhook configurado quando o processamento for concluído. A estrutura do payload é idêntica à resposta do endpoint GET /onboarding/api/v1/know/business/.