# Consulta Gravame

O serviço Consulta Gravame retorna dados sobre restrições financeiras vinculadas a veículos, como financiamentos ou leasing.

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

## Quando usar

Descrição

O serviço de Consulta Gravame fornece informações que garantem segurança ao credor sobre a posse do bem até a quitação da dívida.

Esse dado é essencial para transações de compra e venda, permitindo verificar se o veículo pode ser transferido sem pendências.

Também são apresentados detalhes adicionais, como a instituição credora e a situação do débito.

## 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.ufPlaca` | texto |
| `identificacao.chassi` | texto |
| `identificacao.renavam` | texto |
| `identificacao.anoFabricacao` | número |
| `identificacao.anoModelo` | número |
| `identificacao.documentoProprietario` | texto |
| `temGravame` | booleano |
| `descricaoStatus` | texto |
| `statusVeiculo` | texto |
| `gravame.financeira.nome` | texto |
| `gravame.financeira.codigo` | texto |
| `gravame.financeira.documento` | texto |
| `gravame.contrato.numero` | texto |
| `gravame.contrato.nomeFinanciado` | texto |
| `gravame.contrato.documentoFinanciado` | texto |
| `gravame.contrato.dataInicio` | texto |
| `gravame.contrato.dataVigencia` | texto |
| `gravame.contrato.uf` | 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 Gravame",
  "query_slug": "consulta-gravame",
  "data": {
    "identificacao": {
      "placa": "texto",
      "ufPlaca": "texto",
      "chassi": "texto",
      "renavam": "texto",
      "anoFabricacao": 0,
      "anoModelo": 0,
      "documentoProprietario": "texto"
    },
    "temGravame": false,
    "descricaoStatus": "texto",
    "statusVeiculo": "texto",
    "gravame": {
      "financeira": {
        "nome": "texto",
        "codigo": null,
        "documento": null
      },
      "contrato": {
        "numero": "texto",
        "nomeFinanciado": null,
        "documentoFinanciado": null,
        "dataInicio": null,
        "dataVigencia": null,
        "uf": "texto"
      }
    }
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "4.500"
}
```