Skip to main content

​
O que é Enriquecimento de Placa?

O serviço de Enriquecimento de Placa permite consultar informações completas e atualizadas sobre um veículo utilizando apenas a placa. Este endpoint retorna dados cadastrais do veículo registrados nos órgãos de trânsito (Detrans).
Cobertura Nacional: O serviço funciona para veículos registrados em todos os 26 estados brasileiros e no Distrito Federal.

​
Informações Disponíveis

Ao consultar uma placa, você terá acesso a diversas informações do veículo:

Dados do Veículo

  • Marca e modelo
  • Ano de fabricação e modelo
  • Cor do veículo
  • Tipo e categoria
  • Chassi e RENAVAM

Dados de Registro

  • UF de registro
  • Município de emplacamento
  • Data de registro
  • Situação do veículo
  • Restrições (se houver)

Características Técnicas

  • Potência do motor
  • Cilindradas
  • Capacidade de passageiros
  • Capacidade de carga
  • Combustível

Informações Adicionais

  • Espécie do veículo
  • Procedência (nacional/importado)
  • Carroceria
  • Eixos

​
Como Usar

​
Endpoint

GET /api/v1/vehicle/enrichment/{licensePlate}

​
Parâmetros

​
placa
string
required
Placa do veículo no formato ABC1234 ou ABC1D23 (Mercosul). Pode ser informada com ou sem hífen.
​
uf
string
Sigla do estado (opcional). Quando informado, otimiza a consulta direcionando para o Detran específico.

​
Exemplo de Requisição

curl --request GET \
  --url 'https://api.uvvipague.com.br/api/v1/vehicle/enrichment/ABC1234?uf=SP' \
  --header 'x-api-key: SUA_API_KEY_AQUI' \
  --header 'Content-Type: application/json'

​
Exemplo de Resposta

{
  "success": true,
  "data": {
    "placa": "ABC1234",
    "renavam": "12345678901",
    "chassi": "9BWZZZ377VT004251",
    "uf": "SP",
    "municipio": "São Paulo",
    "marca": "VOLKSWAGEN",
    "modelo": "GOL 1.0",
    "anoFabricacao": "2020",
    "anoModelo": "2021",
    "cor": "PRATA",
    "combustivel": "FLEX",
    "categoria": "PARTICULAR",
    "especie": "PASSAGEIRO",
    "tipo": "AUTOMOVEL",
    "carroceria": "HATCH",
    "potencia": "75",
    "cilindradas": "999",
    "capacidadePassageiros": 5,
    "procedencia": "NACIONAL",
    "situacao": "CIRCULACAO",
    "dataRegistro": "2020-08-15",
    "restricoes": []
  }
}

​
Casos de Uso

Valide automaticamente as informações do veículo antes de aprovar um financiamento ou empréstimo, garantindo que os dados fornecidos pelo cliente estão corretos.
Identifique automaticamente veículos que entram em estacionamentos e colete informações para controle de acesso e cobrança.
Obtenha dados precisos do veículo para cálculo de apólices e validação de informações em processos de sinistro.
Enriqueça anúncios automaticamente com informações oficiais do veículo, aumentando a confiança dos compradores.
Mantenha um cadastro atualizado e completo de todos os veículos da frota com dados oficiais dos Detrans.
Utilize o enriquecimento como primeiro passo antes de consultar débitos veiculares, garantindo que está consultando o veículo correto.

​
Códigos de Resposta

​
200
Success
Consulta realizada com sucesso. Os dados do veículo foram encontrados e retornados.
​
400
Bad Request
Requisição inválida. Verifique se a placa foi informada no formato correto.
​
401
Unauthorized
Token de autenticação inválido ou ausente. Verifique suas credenciais.
​
404
Not Found
Veículo não encontrado. A placa informada não existe nos registros dos Detrans.
​
429
Too Many Requests
Limite de requisições excedido. Aguarde antes de fazer novas consultas.
​
500
Server Error
Erro interno do servidor. Entre em contato com o suporte se o problema persistir.

​
Boas Práticas

1

Valide o Formato da Placa

Antes de enviar a requisição, valide se a placa está no formato correto (ABC1234 ou ABC1D23). Isso evita erros desnecessários.
2

Informe a UF quando Possível

Passar o parâmetro uf otimiza a consulta e reduz o tempo de resposta, pois a API consulta diretamente o Detran específico.
3

Implemente Cache

Considere cachear os resultados por um período razoável (ex: 24-48 horas) para evitar consultas duplicadas do mesmo veículo.
4

Trate Erros Adequadamente

Implemente tratamento de erros robusto, especialmente para casos de placa não encontrada ou timeout de conexão.
5

Respeite os Limites de Rate

Monitore seu uso da API e implemente controles para não exceder os limites de requisições do seu plano.

​
Limitações e Considerações

Dados Sujeitos a Disponibilidade: As informações retornadas dependem da disponibilidade dos sistemas dos Detrans. Em casos de instabilidade, alguns dados podem não estar disponíveis temporariamente.
  • Os dados retornados são os registrados oficialmente nos Detrans
  • Alterações recentes no veículo podem levar alguns dias para serem refletidas
  • Veículos muito antigos podem ter informações limitadas
  • A consulta não retorna dados do proprietário por questões de privacidade (LGPD)

​
Próximos Passos

Consulta de Débitos

Após enriquecer os dados, consulte os débitos pendentes do veículo.

Autenticação

Aprenda como obter e usar seu token de autenticação.

Webhooks

Configure notificações para eventos importantes.

Fluxo Completo

Veja o fluxo completo de consulta e pagamento.