Veículos

Consulta Roubo e Furto

O serviço de Consulta Roubo e Furto retorna informações sobre veículos reportados como roubados ou furtados, essenciais para verificar a legalidade em transações.

Quando usar

Descrição

O serviço de Consulta Roubo e Furto fornece registros que indicam se um veículo foi reportado como roubado ou furtado, com detalhes sobre data da ocorrência, situação atual do veículo e recuperação.

Essas informações ajudam a evitar problemas em transações de compra e venda.

Também são apresentados dados sobre o órgão responsável pelo registro e eventuais restrições ativas.

Requisição

Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.

POST /api/v1/{tenant}/veiculos/consulta-roubo-e-furto

CampoObrigatórioDescrição
plate sim Placa do veículo, antiga ou Mercosul.
{
  "plate": "ABC1D23"
}

Campos de retorno

Campos dentro de data. [] indica lista.

CampoTipo
placa texto
qtdOcorrencias número
ocorrencias[].tipoOcorrencia texto
ocorrencias[].tipoDeclaracao texto
ocorrencias[].dataOcorrencia texto
ocorrencias[].uf texto
ocorrencias[].cidade texto

Exemplo de resposta

Estrutura real da resposta, com valores fictícios.

{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Consulta Roubo e Furto",
  "query_slug": "consulta-roubo-e-furto",
  "data": {
    "placa": "texto",
    "qtdOcorrencias": 0,
    "ocorrencias": [
      {
        "tipoOcorrencia": "texto",
        "tipoDeclaracao": "texto",
        "dataOcorrencia": "texto",
        "uf": "texto",
        "cidade": "texto"
      }
    ]
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "5.660"
}

Cobrança e respostas

  • O valor é cobrado por consulta bem-sucedida.
  • 200 — consulta processada (veja status no corpo da resposta)
  • 401 — token ausente, inválido, inativo ou expirado
  • 403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
  • 422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
  • 429 — limite de requisições por minuto da chave excedido
  • 504 — tempo máximo de execução do serviço excedido