# Consulta Proprietário Atual

O serviço de Consulta Proprietário Atual retorna informações sobre o proprietário atual do veículo, essenciais para verificar a legalidade em transações.

- **Identificador:** `veiculos/consulta-proprietario-atual`
- **Categoria:** Veículos
- **Audiência:** Veículo
- **Endpoint:** `POST /api/v1/{tenant}/veiculos/consulta-proprietario-atual`
- **Preço de tabela:** R$ 2,400 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/veiculos/consulta-proprietario-atual

## Quando usar

Descrição

O serviço de Consulta Proprietário Atual fornece informações sobre o proprietário atual do veículo, essenciais para verificar a legalidade em transações.

Ele inclui detalhes sobre o proprietário, como nome, documento e renavam.

Essas informações são essenciais para transações de compra e venda, permitindo verificar se o veículo pode ser transferido sem pendências judiciais ou bloqueios.

Também são apresentados dados sobre o proprietário e endereço.

## Parâmetros (corpo JSON)

| Campo | Obrigatório | Descrição |
|---|---|---|
| `plate` | sim | Placa do veículo, antiga ou Mercosul. |

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `identificacao.placa` | texto |
| `identificacao.chassi` | texto |
| `identificacao.renavam` | texto |
| `proprietario.nome` | texto |
| `proprietario.documento` | texto |
| `proprietario.tipoDocumento` | texto |
| `marca.descricao` | texto |
| `marca.fipeId` | número |
| `marca.sintetico` | booleano |
| `modelo.descricao` | texto |
| `modelo.bruto` | texto |
| `modelo.sintetico` | booleano |
| `modelo.versao` | texto |
| `modelo.anoFabricacao` | número |
| `modelo.anoModelo` | número |
| `classificacao.tipoVeiculo` | texto |
| `classificacao.especie` | texto |
| `classificacao.combustivel` | texto |
| `carroceria.tipo` | texto |
| `carroceria.capacidadeCarga` | texto |
| `cor.descricao` | texto |
| `localizacao.uf` | texto |
| `localizacao.cidade` | texto |
| `origem.procedencia` | texto |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Consulta Proprietário Atual",
  "query_slug": "consulta-proprietario-atual",
  "data": {
    "identificacao": {
      "placa": "texto",
      "chassi": "texto",
      "renavam": "texto"
    },
    "proprietario": {
      "nome": "texto",
      "documento": "texto",
      "tipoDocumento": "texto"
    },
    "marca": {
      "descricao": "texto",
      "fipeId": 0,
      "sintetico": false
    },
    "modelo": {
      "descricao": "texto",
      "bruto": "texto",
      "sintetico": false,
      "versao": null,
      "anoFabricacao": 0,
      "anoModelo": 0
    },
    "classificacao": {
      "tipoVeiculo": "texto",
      "especie": "texto",
      "combustivel": null
    },
    "carroceria": {
      "tipo": null,
      "capacidadeCarga": null
    },
    "cor": {
      "descricao": "texto"
    },
    "localizacao": {
      "uf": "texto",
      "cidade": "texto"
    },
    "origem": {
      "procedencia": null
    }
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "2.400"
}
```
