Skip to main content
POST
/
bureau
/
api
/
v1
/
person
/
async
Consulta Bureau Person Async
curl --request POST \
  --url https://api.valid.com/bureau/api/v1/person/async \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "key": "<string>",
  "datasets": [
    "<string>"
  ],
  "datasetPackageId": "<string>",
  "webhookUrl": "<string>",
  "webhookBasicAuth": "<string>",
  "refreshData": true
}
'
{
  "code": "<string>",
  "message": "<string>"
}

​
Request Body

​
key
string
required
CPF ou CNPJ da pessoaExemplo: 12345678901
​
datasets
string[]
Datasets a serem consultadosExemplo: ["basic", "addresses"]
​
datasetPackageId
string
ID do pacote de datasetsFormato: UUIDExemplo: 05be75cc-8f8a-414a-891f-434aa9b4e7a5
​
webhookUrl
string
required
URL de callback para receber o resultadoFormato: URIExemplo: https://seusistema.com/webhook
​
webhookBasicAuth
string
Autenticacao basica para o webhook (username:password)Exemplo: usuario:senha
​
refreshData
boolean
Forca a busca de dados atualizadosExemplo: true
Use os mesmos codigos de datasets documentados em Datasets PF e PJ.

​
Response

Retorna confirmacao de recebimento/processamento da consulta. O resultado final e entregue no webhook informado.

​
Exemplo de sucesso (200 OK)

{
  "requestId": "05be75cc-8f8a-414a-891f-434aa9b4e7a5",
  "createdAt": "2026-03-12T10:30:00Z"
}

​
Webhook Content

O payload enviado para o webhook contem o resultado da consulta solicitada.

​
Exemplo de payload do webhook

{
  "result": {
    "requestId": "05be75cc-8f8a-414a-891f-434aa9b4e7a5",
    "key": "12345678900",
    "datasets": [
      {
        "dataset": "basic",
        "data": {
          "document": "12345678900",
          "name": "Joao da Silva",
          "motherName": "Maria da Silva",
          "birthDate": "1990-05-21",
          "status": "REGULAR"
        }
      },
      {
        "dataset": "addresses",
        "data": {
          "addresses": [
            {
              "street": "Rua das Flores",
              "number": "123",
              "complement": "Apto 45",
              "district": "Centro",
              "city": "Sao Paulo",
              "state": "SP",
              "zipCode": "01001-000",
              "country": "BR"
            }
          ]
        }
      }
    ]
  }
}

​
Respostas de Erro

​
code
string
Codigo do erro que categoriza o tipo de erroExemplo: VALIDATION_ERROR
​
message
string
Mensagem de erroExemplo: The request is invalid