Documentação

Sobre

A API Fipe expressa preços médios de veículos anunciados pelos vendedores, no mercado nacional, servindo como um parâmetro para negociações ou avaliações.

Token

O Token para uso da API é fornecido após a confirmação de pagamento do seu Plano.

*Você pode obter um token de demonstração gratuito, basta criar sua conta no site e ir até o menu (Meus Planos) para visualizar o token.

Informações

A API fornece os dados através de uma URL utilizando o método (GET).
Segue abaixo a url de exemplo:

O parametro (tipo) serve para listar os tipos de veículos: carros, motos, caminhoes ou fipe.
O parametro tipo com valor fipe consulta todos os veículos com aquele codigo fipe.

*Veículo com o ano 32000 é referente a um veículo 0 Km.

*O parâmetro "codAno" é composto pela junção do ano de fabricação do veículo (-) código do combustivel. Sendo esses 1(Gasolina), 2(Álcool) e 3(Diesel). Ex. 2012-1.

Utilização da API

Marcas

Primeiramente, liste as marcas de um tipo de veiculo que deseja através da URL abaixo. Neste exemplo vamos listar por marcas de carros.

Você receberá os dados no formato JSON:

[
    {
        "codMarca": 1,
        "refFipe": 286,
        "nomeMarca": "Acura",
        "tipoVeiculo": 1
    },
    {
        "codMarca": 2,
        "refFipe": 286,
        "nomeMarca": "Agrale",
        "tipoVeiculo": 1
    },
    {
        "codMarca": 3,
        "refFipe": 286,
        "nomeMarca": "Alfa Romeo",
        "tipoVeiculo": 1
    },....
												

Modelos

Em seguida será possível obter a listagem dos veículos de uma determinada marca, basta informar na URL o código da marca (codMarca). Ex. A marca (BMW) tem como seu (codMarca) o número (7). Veja como fica abaixo.

[
    {
        "codModelo": "6146",
        "codMarca": 7,
        "nomeModelo": "116iA 1.6 TB 16V 136cv 5p",
        "refFipe": 286,
        "tipoVeiculo": 1
    },
    {
        "codModelo": "8946",
        "codMarca": 7,
        "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
        "refFipe": 286,
        "tipoVeiculo": 1
    },
    {
        "codModelo": "5576",
        "codMarca": 7,
        "nomeModelo": "118iA 2.0 16V 136cv 3p",
        "refFipe": 286,
        "tipoVeiculo": 1
    },....
												

Anos

Ao escolher o modelo, é possível obter os anos disponíveis do mesmo.
Basta informar o código da marca (codMarca) e também o código do modelo (codModelo) na URL.
Ex. A marca (BMW) tem como seu (codMarca) o número (7) e o modelo (118i Sport 1.5 TB 12V Aut. 5p) tem o seu (codModelo) o número (8946). A URL vai ficar assim.

[
    {
        "codModelo": 8946,
        "codMarca": 7,
        "tipoVeiculo": 1,
        "refFipe": "286",
        "nomeAno": "32000 Gasolina",
        "codAno": "32000-1"
    },
    {
        "codModelo": 8946,
        "codMarca": 7,
        "tipoVeiculo": 1,
        "refFipe": "286",
        "nomeAno": "2022 Gasolina",
        "codAno": "2022-1"
    },
    {
        "codModelo": 8946,
        "codMarca": 7,
        "tipoVeiculo": 1,
        "refFipe": "286",
        "nomeAno": "2021 Gasolina",
        "codAno": "2021-1"
    },....
												

Valor

Para finalizar, adicionamos mais um parâmetro a URL, o código do ano (codAno).
Assim é possível visualizar o preço conforme a Tabela FIPE para o veiculo, informando [tipo]/[marca]/[modelo]/[ano].
Continuando com o exemplo a cima, para obter o valor do veiculo de tipo(carros) da marca BMW(7), do modelo 118i Sport 1.5 TB 12V Aut. 5p(8946), de ano 2021 a Gasolina(2021-1) montamos a seguinte URL:

{
"codModelo":"8946",
"codMarca":7,
"tipoCombustivel":"Gasolina",
"nomeModelo":"118i Sport 1.5 TB 12V Aut. 5p",
"siglaCombustivel":"G",
"codFipe":"009258-4",
"refFipe":286,
"nomeMarca":"BMW",
"refMes":"junho de 2022 ",
"valorVeiculo":"R$ 228.091,00",
"anoModelo":"2021",
"tipoVeiculo":1
}
												

Desta forma recebemos todos os dados do veículo (118i Sport 1.5 TB 12V Aut. 5p) da marca BMW, inclusive seu preço atual.

Código Fipe

Caso deseje consultar os possíveis veículos a partir do Código Fipe, você pode requisita-los da seguinte forma /fipe/codigo-fipe.

[
    {
        "codModelo": "8946",
        "codMarca": 7,
        "tipoCombustivel": "Gasolina",
        "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
        "siglaCombustivel": "G",
        "codFipe": "009258-4",
        "refFipe": 286,
        "nomeMarca": "BMW",
        "refMes": "junho de 2022 ",
        "valorVeiculo": "R$ 289.928,00",
        "anoModelo": "32000",
        "tipoVeiculo": 1
    },....
												

De resposta, recebemos o array JSON relacionado aos dados dos veículos que correspondem ao Código FIPE informado.

Código Fipe + Ano

Caso deseje consultar o preço do veiculo a partir do Código Fipe(codFipe) e o ano(codAno), você pode requisita-los da seguinte forma /fipe/codFipe/codAno.

{
    "codModelo": "8946",
    "codMarca": 7,
    "tipoCombustivel": "Gasolina",
    "nomeModelo": "118i Sport 1.5 TB 12V Aut. 5p",
    "siglaCombustivel": "G",
    "codFipe": "009258-4",
    "refFipe": 286,
    "nomeMarca": "BMW",
    "refMes": "junho de 2022 ",
    "valorVeiculo": "R$ 228.091,00",
    "anoModelo": "2021",
    "tipoVeiculo": 1
}
												

De resposta, recebemos o objeto JSON relacionado aso dados dos veículos que correspondem ao Código FIPE e ano informado.

Obs. Usa-se o parametro (codAno) por existirem casos de veículos com mais de um tipo de combustível no mesmo ano.

Códigos de retorno

Todos os códigos de erro retornam com uma mensagem detalhando o erro.
Exemplo:

{
    "mensagem": "Formado do token inválido! Cod.(7006)"
}