Consulta os veículos de um proprietário

Retorna os veículos registrados no nome do titular a partir do CPF ou CNPJ dele: placa, renavam, marca/modelo, ano, situação e restrições de cada um. É o caminho inverso da consulta por placa.

POST /api/consultas/veiculos-por-proprietario

Consulta os veículos de um proprietário

cURL

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/consultas/veiculos-por-proprietario \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "document": "52998224725"
}
'

200

Example

{
  "statusCode": 200,
  "message": "Consulta concluída com sucesso",
  "timestamp": "2026-07-28T18:00:00.000Z",
  "path": "/api/consultas/veiculos-por-proprietario",
  "result": [
    {
      "base": "CORRECTDATA",
      "placa": "ABC1D23",
      "renavam": "00123456789",
      "municipio": "",
      "uf": "DF",
      "situacao": "",
      "furto": "",
      "remarcacao_chassi": "",
      "restricoes": [
        {},
        {
          "descricao": ""
        },
        {
          "descricao": ""
        },
        {
          "descricao": ""
        }
      ],
      "marca": "HONDA/CG 150 TITAN KS",
      "tipo_veiculo": "",
      "proprietario_nome": "",
      "proprietario_documento": "52998224725",
      "especie": "",
      "nacional": "NÃO",
      "potencia": "",
      "ultima_atualizacao": "",
      "cilindrada": "",
      "capacidade_passageiros": "",
      "cor": "",
      "combustivel": "",
      "ano_fabricacao": "2008",
      "ano_modelo": ""
    }
  ]
}

Autorizações

x-api-key · string · header · obrigatório

Corpo

application/json

document · string · obrigatório

CPF ou CNPJ do proprietário, com ou sem máscara. Separadores (incluindo a barra do CNPJ) são aceitos e ignorados. O dígito verificador é validado antes da consulta.

Exemplo:

"52998224725"

Resposta

200

application/json

Veículos do documento informado. O resultado é um array, com um item por veículo, e base identifica o fornecedor que atendeu. Números (ano, potência, cilindrada, lotação) vêm como string, e furto/remarcacao_chassi são indicadores em string, não booleanos. Espere campo vazio: o fornecedor preenche pouco — na captura que gerou o exemplo, dos 23 campos só oito vieram com conteúdo (base, placa, renavam, uf, marca, nacional, ano_fabricacao e proprietario_documento); os outros quatorze vieram string vazia (""), não ausentes nem null. Quatro pontos de atenção: (1) marca traz marca e modelo na mesma string, e não há campo modelo; (2) restricoes sempre vem com os quatro slots do parser do backend, e um item pode vir {} sem a chave descricao — filtre pelos itens com descricao preenchida, sem confiar no tamanho da lista; (3) nacional: "NÃO" significa "não informado ou importado", os dois indistinguíveis; (4) no fornecedor padrão proprietario_nome vem vazio e proprietario_documento é o próprio documento consultado.

The response is of type object.