Tipos de consulta
A mesma URL faz consultas diferentes. Você escolhe com o parâmetro tipo, e cada tipo tem o seu preço, descontado do saldo só quando o dado é encontrado.
GET https://api.placaefipe.com.br/v1/placas/{placa}?tipo=completaSem tipo, a consulta é basica.
Resumo
Preços de lançamento, com 50% de desconto.
tipo | Nome | Preço | FIPE | Chassi completo | Renavam | Nº do motor |
|---|---|---|---|---|---|---|
basica | Consulta básica + FIPE | de R$ 0,18 por R$ 0,09 | sim | não (só o final) | não | não |
completa | Consulta completa | de R$ 1,20 por R$ 0,60 | sim | sim | sim | sim |
renavam | Consulta Renavam | de R$ 0,72 por R$ 0,36 | não | não | sim | não |
chassi | Consulta de chassi | de R$ 0,72 por R$ 0,36 | não | sim | não | não |
motor | Consulta de número do motor | de R$ 0,72 por R$ 0,36 | não | não | não | sim |
Também aceitamos estes apelidos: basico e simples (= basica), completo e full (= completa) e vin (= chassi). Qualquer outro valor devolve 400 tipo_invalido.
A tabela também sai em JSON, sem chave, em GET https://api.placaefipe.com.br/v1/precos. Veja Saldo e preços.
Básica + FIPE (basica)
R$ 0,09 por consulta (de R$ 0,18). É o tipo padrão.
Retorna marca, modelo, versão, ano de fabricação e modelo, cor, combustível, município, UF, situação, final do chassi (chassi_final, 5 últimos caracteres), dados técnicos (tecnico) e o valor da Tabela FIPE do mês (fipe).
Quando usar: cadastro de veículo, preenchimento automático de formulário, cotação de seguro, avaliação de usado, oficina, frota. Na maioria dos sistemas, é a única consulta de que você precisa.
Completa (completa)
R$ 0,60 por consulta (de R$ 1,20).
Retorna tudo da básica + FIPE e mais o objeto identificacao:
"identificacao": {
"chassi": "9BWZZZ377VT004251",
"renavam": "00123456789",
"numero_motor": "BJG123456"
}Quando usar: quando o sistema precisa identificar o veículo com precisão, além dos dados e da FIPE. Seguradoras, lojas de veículos, despachantes, vistoria e oficinas que conferem chassi e motor.
Renavam (renavam)
R$ 0,36 por consulta (de R$ 0,72).
Retorna só placa, tipo, identificacao.renavam e consulta. Não vêm dados do veículo nem FIPE.
Quando usar: você já tem os dados do veículo e só falta o Renavam, por exemplo para emitir documento, consultar débitos ou licenciamento.
Chassi (chassi)
R$ 0,36 por consulta (de R$ 0,72).
Retorna só placa, tipo, identificacao.chassi (chassi completo, o VIN de 17 caracteres) e consulta.
Quando usar: vistoria, conferência de identificação e busca de peças pelo VIN, quando os outros dados já estão no seu cadastro.
Número do motor (motor)
R$ 0,36 por consulta (de R$ 0,72).
Retorna só placa, tipo, identificacao.numero_motor e consulta.
Quando usar: vistoria, troca de motor e conferência de documentação.
Qual escolher
- Precisa de dados do veículo e/ou FIPE?
basica. - Precisa de dados + FIPE e de pelo menos dois entre chassi, Renavam e motor?
completa: sai mais barato que a básica mais dois avulsos (R$ 0,09 + R$ 0,72 = R$ 0,81). - Precisa só de um desses números, sem os dados do veículo? O avulso:
renavam,chassioumotor. - Precisa de dados + FIPE e de um só desses números? Compare:
completa(R$ 0,60) traz tudo numa chamada;basica+ avulso custa R$ 0,45, mas são duas chamadas.
O que não vendemos de propósito
- FIPE avulsa: a básica já traz a FIPE junto com os dados do veículo por R$ 0,09, mais barato do que uma FIPE separada custaria.
- Motor + chassi juntos: a completa já traz os dois e ainda o Renavam por R$ 0,60, menos do que motor e chassi avulsos somados (R$ 0,72).
Regras que valem para todos os tipos
- O preço só é descontado quando o dado é encontrado.
404 placa_nao_encontradae qualquer erro não descontam nada. - Se o saldo não cobre o tipo pedido, a API responde
402 saldo_insuficientee não consulta. Pode haver saldo para uma básica e não para uma completa. - Nenhum tipo retorna dados do proprietário (nome, CPF, endereço), por causa da LGPD.
- Com chave de teste (
pf_test_...), todos os tipos devolvem dados de exemplo, de graça (valor_cobrado: 0,cobrada: false). - Trate
identificacaoe cada campo dentro dela como opcionais: podem virnullquando o registro não tem a informação.
Campos e exemplos completos de resposta em Consultar placa.
