Pular para o conteúdo
ZapCar
Developersv1

Tabela FIPE: referências, marcas, modelos e anos

Navegue a Tabela FIPE sem placa. As listas são gratuitas: só contam no limite de requisições.

GET/v1/fipe/tabela/referencias
GET/v1/fipe/tabela/{tipo}/marcas
GET/v1/fipe/tabela/{tipo}/marcas/{marca}/modelos
GET/v1/fipe/tabela/{tipo}/marcas/{marca}/modelos/{modelo}/anos
GET/v1/fipe/tabela/{tipo}/codigo/{codigo_fipe}/anos
GratuitoLeituraSandbox

A Tabela FIPE sem placa: navegue por tipo, marca, modelo e ano, ou comece direto pelo código FIPE que você já tem (por exemplo, o codigo_fipe devolvido por POST /v1/fipe). As listas são gratuitas: só contam no limite de requisições. O valor sai em POST /v1/fipe/tabela.

  1. Passo 1: (Opcional) Escolha o mês

    GET /v1/fipe/tabela/referencias lista os meses publicados, do mais recente para o mais antigo. Passe o código em ?referencia= nas próximas chamadas para consultar um mês passado; sem ele, vale o mês vigente.

  2. Passo 2: Marca

    GET /v1/fipe/tabela/{tipo}/marcas, com tipo = carros, motos ou caminhoes.

  3. Passo 3: Modelo

    …/marcas/{marca}/modelos, com o código numérico da marca.

  4. Passo 4: Ano

    …/modelos/{modelo}/anos. O código do ano ("2014-3") é o ano do POST; 32000 é zero km. Já tem o código FIPE? Pule marca e modelo com GET /v1/fipe/tabela/{tipo}/codigo/{codigo_fipe}/anos.
Informação:
Com a chave de teste, as listas vêm com dados reais (são públicas e gratuitas), marcadas com ambiente: "test".
Pedido
curl "https://api.zapcarconsulta.com.br/v1/fipe/tabela/carros/marcas/59/modelos/5940/anos" \
  -H "Authorization: Bearer $ZAPCAR_API_KEY"
Resposta
{
  "tipo": "carros",
  "marca": "59",
  "modelo": "5940",
  "referencia": null,
  "anos": [
    { "codigo": "2014-3", "nome": "2014 Diesel" },
    { "codigo": "2013-3", "nome": "2013 Diesel" }
  ]
}
Testar no API Explorer (sandbox)

Meses de referência da Tabela FIPE

GET/v1/fipe/tabela/referencias

Cabeçalhos

Authorizationstringobrigatório
Sua chave no formato Bearer zc_live_… (produção) ou Bearer zc_test_… (teste). O cabeçalho X-API-Key também é aceito. Ver Autenticação.

Exemplo: Bearer zc_test_…

  • 200
    Meses publicados.Corpo: FipeReferencias
  • 401
    Chave ausente, inválida ou revogada.Corpo: ApiError
  • 429
    Rate limit excedido. Respeite o header Retry-After (segundos) antes de repetir. Não consome saldo.Corpo: ApiError
  • 500
    Falha interna inesperada. É transitória (retryable: true); informe o request_id ao suporte se persistir.Corpo: ApiError
  • 502
    A fonte respondeu com erro (FIPE). Transitório: nada foi cobrado, o valor já foi estornado.Corpo: ApiError
  • 503
    Fornecedor temporariamente indisponível (circuito aberto). Transitório.Corpo: ApiError

Marcas por tipo de veículo

GET/v1/fipe/tabela/{tipo}/marcas

Parâmetros de caminho

tipostringobrigatório
Tipo de veículo da Tabela FIPE.
Valores:carrosmotoscaminhoes

Parâmetros de query

referenciastringopcional
Código do mês de referência (de /referencias). Ausente = o mês vigente.

Exemplo: 337

Cabeçalhos

Authorizationstringobrigatório
Sua chave no formato Bearer zc_live_… (produção) ou Bearer zc_test_… (teste). O cabeçalho X-API-Key também é aceito. Ver Autenticação.

Exemplo: Bearer zc_test_…

  • 200
    Marcas do tipo.Corpo: FipeMarcas
  • 400
    Pedido inválido. Nada foi criado nem cobrado. codigo diz o que corrigir.Corpo: ApiError
  • 401
    Chave ausente, inválida ou revogada.Corpo: ApiError
  • 429
    Rate limit excedido. Respeite o header Retry-After (segundos) antes de repetir. Não consome saldo.Corpo: ApiError
  • 500
    Falha interna inesperada. É transitória (retryable: true); informe o request_id ao suporte se persistir.Corpo: ApiError
  • 502
    A fonte respondeu com erro (FIPE). Transitório: nada foi cobrado, o valor já foi estornado.Corpo: ApiError
  • 503
    Fornecedor temporariamente indisponível (circuito aberto). Transitório.Corpo: ApiError

Modelos de uma marca

GET/v1/fipe/tabela/{tipo}/marcas/{marca}/modelos

Parâmetros de caminho

tipostringobrigatório
Tipo de veículo da Tabela FIPE.
Valores:carrosmotoscaminhoes
marcastringobrigatório
Código da marca (de /marcas).

Exemplo: 59

Parâmetros de query

referenciastringopcional
Código do mês de referência (de /referencias). Ausente = o mês vigente.

Exemplo: 337

Cabeçalhos

Authorizationstringobrigatório
Sua chave no formato Bearer zc_live_… (produção) ou Bearer zc_test_… (teste). O cabeçalho X-API-Key também é aceito. Ver Autenticação.

Exemplo: Bearer zc_test_…

  • 200
    Modelos da marca.Corpo: FipeModelos
  • 400
    Pedido inválido. Nada foi criado nem cobrado. codigo diz o que corrigir.Corpo: ApiError
  • 401
    Chave ausente, inválida ou revogada.Corpo: ApiError
  • 404
    Não encontrado, ou não pertence a esta conta (um id de outro cliente responde 404, nunca o dado).Corpo: ApiError
  • 429
    Rate limit excedido. Respeite o header Retry-After (segundos) antes de repetir. Não consome saldo.Corpo: ApiError
  • 500
    Falha interna inesperada. É transitória (retryable: true); informe o request_id ao suporte se persistir.Corpo: ApiError
  • 502
    A fonte respondeu com erro (FIPE). Transitório: nada foi cobrado, o valor já foi estornado.Corpo: ApiError
  • 503
    Fornecedor temporariamente indisponível (circuito aberto). Transitório.Corpo: ApiError

Anos de um modelo

GET/v1/fipe/tabela/{tipo}/marcas/{marca}/modelos/{modelo}/anos

Parâmetros de caminho

tipostringobrigatório
Tipo de veículo da Tabela FIPE.
Valores:carrosmotoscaminhoes
marcastringobrigatório
Código da marca (de /marcas).

Exemplo: 59

modelostringobrigatório
Código do modelo (de /modelos).

Exemplo: 5940

Parâmetros de query

referenciastringopcional
Código do mês de referência (de /referencias). Ausente = o mês vigente.

Exemplo: 337

Cabeçalhos

Authorizationstringobrigatório
Sua chave no formato Bearer zc_live_… (produção) ou Bearer zc_test_… (teste). O cabeçalho X-API-Key também é aceito. Ver Autenticação.

Exemplo: Bearer zc_test_…

  • 200
    Anos do modelo.Corpo: FipeAnos
  • 400
    Pedido inválido. Nada foi criado nem cobrado. codigo diz o que corrigir.Corpo: ApiError
  • 401
    Chave ausente, inválida ou revogada.Corpo: ApiError
  • 404
    Não encontrado, ou não pertence a esta conta (um id de outro cliente responde 404, nunca o dado).Corpo: ApiError
  • 429
    Rate limit excedido. Respeite o header Retry-After (segundos) antes de repetir. Não consome saldo.Corpo: ApiError
  • 500
    Falha interna inesperada. É transitória (retryable: true); informe o request_id ao suporte se persistir.Corpo: ApiError
  • 502
    A fonte respondeu com erro (FIPE). Transitório: nada foi cobrado, o valor já foi estornado.Corpo: ApiError
  • 503
    Fornecedor temporariamente indisponível (circuito aberto). Transitório.Corpo: ApiError

Anos de um código FIPE

GET/v1/fipe/tabela/{tipo}/codigo/{codigo_fipe}/anos

Parâmetros de caminho

tipostringobrigatório
Tipo de veículo da Tabela FIPE.
Valores:carrosmotoscaminhoes
codigo_fipestringobrigatório
Código FIPE do veículo, formato 000000-0.

Exemplo: 005340-6

Parâmetros de query

referenciastringopcional
Código do mês de referência (de /referencias). Ausente = o mês vigente.

Exemplo: 337

Cabeçalhos

Authorizationstringobrigatório
Sua chave no formato Bearer zc_live_… (produção) ou Bearer zc_test_… (teste). O cabeçalho X-API-Key também é aceito. Ver Autenticação.

Exemplo: Bearer zc_test_…

  • 200
    Anos do código FIPE.Corpo: FipeAnos
  • 400
    Pedido inválido. Nada foi criado nem cobrado. codigo diz o que corrigir.Corpo: ApiError
  • 401
    Chave ausente, inválida ou revogada.Corpo: ApiError
  • 404
    Não encontrado, ou não pertence a esta conta (um id de outro cliente responde 404, nunca o dado).Corpo: ApiError
  • 429
    Rate limit excedido. Respeite o header Retry-After (segundos) antes de repetir. Não consome saldo.Corpo: ApiError
  • 500
    Falha interna inesperada. É transitória (retryable: true); informe o request_id ao suporte se persistir.Corpo: ApiError
  • 502
    A fonte respondeu com erro (FIPE). Transitório: nada foi cobrado, o valor já foi estornado.Corpo: ApiError
  • 503
    Fornecedor temporariamente indisponível (circuito aberto). Transitório.Corpo: ApiError