AAGI-TECObter Chave de API
Veículos/Base Nacional

Documentação

A AGI-TEC é uma interface RESTful que retorna JSON. URL base:

https://agi-tec.ngrok.app

Autenticação

Todas as requisições exigem um token Bearer no cabeçalho Authorization.

Authorization: Bearer SUA_CHAVE_DE_API
GET/consulta?placa={placa}

Consultar Veículo por Placa

Retorna dados completos de um veículo a partir da placa (7 caracteres, sem traços).

curl "https://agi-tec.ngrok.app/consulta?placa=GHK5A78" \
  -H "Authorization: Bearer SUA_CHAVE"
{
  "placa": "GHK5A78",
  "status": "sucesso",
  "timestamp": "2026-05-12T14:32:11.847293",
  "resultado": {
    "consulta": {
      "placa": "GHK5A78",
      "data_consulta": "12/05/2026 14:32:08",
      "possui_restricoes_estaduais": "NAO",
      "possui_motor_alterado": "NAO"
    },
    "dados_fabricacao": {
      "ano_fabricacao": "2022",
      "ano_modelo": "2023",
      "chassi": "9BWZZZ377VT004251",
      "combustivel": "FLEX",
      "cor": "PRATA",
      "marca_modelo": "VW/GOL 1.0 12V MPI TOTAL FLEX",
      "municipio": "SAO PAULO",
      "nacionalidade": "NACIONAL",
      "numero_motor": "EA211A1234567",
      "registro_di": "NAO CONSTA",
      "tipo_veiculo": "AUTOMOVEL",
      "uf": "SP"
    },
    "dados_basicos": {
      "caixa_cambio": "MANUAL",
      "capacidade_maxima_tracao": "0.0",
      "cilindradas": "999",
      "eixo_diferencial": "NAO CONSTA",
      "numero_3_eixo": "NAO CONSTA",
      "numero_carroceria": "NAO CONSTA",
      "potencia": "75",
      "tipo_carroceria": "NAO APLICAVEL",
      "peso_bruto": "1450",
      "capacidade_passageiros": "5"
    },
    "cadastro_estadual": {
      "categoria": "PARTICULAR",
      "combustivel": "FLEX",
      "cor": "PRATA",
      "data_licenciamento": "2025",
      "data_emissao_crv": "15/03/2023",
      "especie": "PASSAGEIRO",
      "exercicio_licenciamento": "2026",
      "motor": "EA211A1234567"
    },
    "municipio_uf_renavam": {
      "municipio": "SAO PAULO",
      "renavam": "01234567890",
      "situacao_veiculo": "ATIVO",
      "tipo_marcacao_chassi": "NORMAL",
      "uf": "SP"
    },
    "restricoes_estaduais": {
      "administrativa": "NADA CONSTA",
      "comunicacao_venda": "NADA CONSTA",
      "data_tributaria": "NADA CONSTA",
      "financeira": "NADA CONSTA",
      "guincho": "NADA CONSTA",
      "judicial": "NADA CONSTA",
      "arrendamento": "NADA CONSTA",
      "restricao_1": "NADA CONSTA",
      "restricao_2": "NADA CONSTA",
      "restricao_3": "NADA CONSTA",
      "restricao_4": "NADA CONSTA",
      "renajud": "NADA CONSTA",
      "roubo": "NADA CONSTA",
      "tributaria": "NADA CONSTA",
      "observacoes": "NADA CONSTA"
    },
    "gravame": {
      "restricao_financeira": "NAO CONSTA",
      "nome_financeira": "NAO CONSTA",
      "data_intencao": "NAO CONSTA",
      "documento_financeira": "NAO CONSTA"
    },
    "alerta_debitos": {
      "dpvat": "NADA CONSTA",
      "ipva": "NADA CONSTA",
      "licenciamento": "NADA CONSTA",
      "multa": "NADA CONSTA"
    },
    "valores_debitos": {
      "cetesb": "R$ 0,00",
      "der": "R$ 0,00",
      "dersa": "R$ 0,00",
      "detran": "R$ 0,00",
      "dpvat": "R$ 0,00",
      "ipva": "R$ 0,00",
      "licenciamento": "R$ 0,00",
      "multas": "R$ 0,00",
      "municipais": "R$ 0,00",
      "prf": "R$ 0,00"
    },
    "historico_proprietarios": {
      "atual": "JOSE DA SILVA",
      "anterior": "NAO CONSTA"
    }
  }
}

Campos do resultado

Estrutura completa do objeto resultado. Clique em cada grupo para expandir.

consulta

placaPlaca do veículo consultado
data_consultaData e hora da consulta
possui_restricoes_estaduais"SIM" ou "NAO"
possui_motor_alterado"SIM" ou "NAO"

dados_fabricacao

ano_fabricacaoAno de fabricação
ano_modeloAno do modelo
chassiNúmero do chassi (17 caracteres)
combustivelEx.: "FLEX", "GASOLINA", "DIESEL"
corCor predominante
marca_modeloFabricante e modelo completo
municipioMunicípio de emplacamento
nacionalidade"NACIONAL" ou "ESTRANGEIRO"
numero_motorNúmero do motor
registro_diNúmero do DI (importados)
tipo_veiculoEx.: "AUTOMOVEL", "MOTOCICLETA", "CAMINHAO"
ufEstado de emplacamento

dados_basicos

caixa_cambio"MANUAL" ou "AUTOMATICO"
capacidade_maxima_tracaoCapacidade de tração (toneladas)
cilindradasCilindradas do motor
eixo_diferencialInformação de eixo
numero_3_eixoNúmero do 3º eixo (quando aplicável)
numero_carroceriaNúmero da carroceria
potenciaPotência em CV
tipo_carroceriaEx.: "NAO APLICAVEL", "BAU"
peso_brutoPeso bruto total em kg
capacidade_passageirosLotação

cadastro_estadual

categoriaEx.: "PARTICULAR", "COMERCIAL"
combustivelCombustível (registro estadual)
corCor (registro estadual)
data_licenciamentoAno do último licenciamento
data_emissao_crvData de emissão do CRV
especieEx.: "PASSAGEIRO", "CARGA"
exercicio_licenciamentoExercício vigente
motorNúmero do motor (registro estadual)

municipio_uf_renavam

municipioMunicípio atual
renavamRENAVAM (11 dígitos)
situacao_veiculoEx.: "ATIVO", "BAIXADO"
tipo_marcacao_chassiEx.: "NORMAL"
ufEstado atual

restricoes_estaduais

Campos sem ocorrência retornam "NADA CONSTA".

administrativaRestrição administrativa
comunicacao_vendaComunicação de venda registrada
data_tributariaData de restrição tributária
financeiraRestrição de alienação/financiamento
guinchoOrdem de guincho ativa
judicialBloqueio judicial
arrendamentoRestrição de arrendamento
restricao_1 … 4Restrições adicionais
renajudBloqueio via RENAJUD
rouboRegistro de roubo ou furto
tributariaRestrição tributária
observacoesObservações gerais

gravame

restricao_financeiraTipo de gravame (ex.: "ALIENACAO FIDUCIARIA")
nome_financeiraNome da instituição financeira
data_intencaoData de registro
documento_financeiraCNPJ/CPF da financeira

alerta_debitos

dpvat"PENDENTE" ou "NADA CONSTA"
ipva"PENDENTE" ou "NADA CONSTA"
licenciamento"PENDENTE" ou "NADA CONSTA"
multa"PENDENTE" ou "NADA CONSTA"

valores_debitos

Valor em reais de cada tipo de débito (ex.: "R$ 1.240,50").

cetesbDébitos CETESB
derDébitos DER
dersaDébitos DERSA
detranDébitos DETRAN
dpvatDPVAT
ipvaIPVA
licenciamentoLicenciamento
multasMultas
municipaisDébitos municipais
prfMultas PRF

historico_proprietarios

atualNome do proprietário atual
anteriorNome do proprietário anterior

Erros

CódigoSignificado
400Requisição inválida (placa ausente ou com tamanho incorreto)
401Chave de API ausente ou inválida
403IP bloqueado por excesso de tentativas inválidas (desbloqueio em 1h)
404Veículo não encontrado
429Serviço ocupado — tente novamente em 15 a 30 segundos
500Erro ao processar a consulta — tente novamente em 30 segundos
503Serviço temporariamente indisponível — tente novamente em 30 segundos
504Tempo limite excedido — tente novamente

Exemplo de resposta de erro:

{
  "placa": "ABC1234",
  "status": "erro",
  "erro": "Veículo não encontrado, tente novamente em alguns segundos.",
  "timestamp": "2026-05-12T14:40:00.000000"
}

Exemplo de erro de autenticação:

{
  "erro": "Não autorizado",
  "mensagem": "Token de autenticação inválido ou não fornecido",
  "instrucoes": "Inclua o header: Authorization: Bearer <seu_token>"
}

Observações

  • Campos sem informação disponível retornam "NAO CONSTA".
  • Campos de restrição sem ocorrência retornam "NADA CONSTA".
  • Configure o timeout do seu cliente HTTP para no mínimo 90 segundos.
  • A placa deve ter exatamente 7 caracteres, sem traços ou espaços.
  • Nunca exponha sua chave de API em código público ou frontend.