{
  "info": {
    "name": "FIPE Developer API v1",
    "_postman_id": "fipe-developer-api-v1",
    "description": "Coleção da API FIPE.\n\n## Autenticação\nTodas as rotas exigem uma API Key enviada no header `Authorization: Bearer <SUA_API_KEY>` (o header `x-api-key: <SUA_API_KEY>` também é aceito).\n\nA autenticação Bearer já está configurada no nível da coleção e é herdada por todas as requisições.\n\n## Como usar\n1. Abra a aba **Variables** da coleção.\n2. Defina `api_key` com a sua API Key (gerada no dashboard do portal).\n3. A variável `base_url` já vem configurada com a URL de produção (`https://apifipe.com`).\n\n## Códigos de status\n- `200 OK` — Requisição bem-sucedida.\n- `400 Bad Request` — Parâmetro de path inválido (ex.: id não numérico).\n- `401 Unauthorized` — Header Authorization ausente.\n- `403 Forbidden` — API Key inválida ou revogada.\n- `500 Server Error` — Erro interno ao consultar os dados.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://apifipe.com",
      "type": "string"
    },
    {
      "key": "api_key",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Listar Tipos de Veículo",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/v1/tipos-veiculo",
          "host": ["{{base_url}}"],
          "path": ["api", "v1", "tipos-veiculo"]
        },
        "description": "Retorna todos os tipos de veículos disponíveis na tabela FIPE (carros, motos, caminhões)."
      },
      "response": [
        {
          "name": "200 OK",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/tipos-veiculo",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "tipos-veiculo"]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "[\n  { \"id\": 1, \"tipo\": \"carros e utilitarios pequenos\" },\n  { \"id\": 2, \"tipo\": \"motos\" },\n  { \"id\": 3, \"tipo\": \"caminhoes e micro-onibus\" }\n]"
        }
      ]
    },
    {
      "name": "Listar Tabelas de Referência",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/v1/tabelas-referencia",
          "host": ["{{base_url}}"],
          "path": ["api", "v1", "tabelas-referencia"]
        },
        "description": "Retorna os meses de referência para os quais existem dados de preço disponíveis."
      },
      "response": [
        {
          "name": "200 OK",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/tabelas-referencia",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "tabelas-referencia"]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "[\n  { \"id\": 334, \"tabela_referencia\": \"junho/2026\" }\n]"
        }
      ]
    },
    {
      "name": "Listar Marcas",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/v1/marcas?tipo=1",
          "host": ["{{base_url}}"],
          "path": ["api", "v1", "marcas"],
          "query": [
            {
              "key": "tipo",
              "value": "1",
              "description": "(Opcional) Código do tipo de veículo (ex.: 1 = Carros, 2 = Motos)."
            }
          ]
        },
        "description": "Retorna a lista de todas as marcas de veículos. Pode-se filtrar por tipo de veículo usando o parâmetro 'tipo'."
      },
      "response": [
        {
          "name": "200 OK",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/marcas?tipo=1",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "marcas"],
              "query": [{ "key": "tipo", "value": "1" }]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "[\n  { \"id\": 1, \"marca\": \"Acura\" }\n]"
        }
      ]
    },
    {
      "name": "Listar Modelos de uma Marca",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/v1/marcas/:id/modelos",
          "host": ["{{base_url}}"],
          "path": ["api", "v1", "marcas", ":id", "modelos"],
          "variable": [
            {
              "key": "id",
              "value": "2",
              "description": "ID único da marca no banco de dados."
            }
          ]
        },
        "description": "Retorna todos os modelos de veículos associados ao ID da marca especificada."
      },
      "response": [
        {
          "name": "200 OK",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/marcas/1/modelos",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "marcas", "1", "modelos"]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "[\n  { \"id\": 2, \"modelo\": \"Integra GS 1.8\" }\n]"
        }
      ]
    },
    {
      "name": "Listar Anos de um Modelo",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/v1/modelos/:id/anos",
          "host": ["{{base_url}}"],
          "path": ["api", "v1", "modelos", ":id", "anos"],
          "variable": [
            {
              "key": "id",
              "value": "2",
              "description": "ID único do modelo."
            }
          ]
        },
        "description": "Retorna os anos de fabricação e tipos de combustível disponíveis para o modelo especificado."
      },
      "response": [
        {
          "name": "200 OK",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/modelos/2/anos",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "modelos", "2", "anos"]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "[\n  { \"id\": 2, \"ano_modelo\": 1992, \"ano_modelo_texto\": \"1992\", \"combustivel\": \"Gasolina\" },\n  { \"id\": 3, \"ano_modelo\": 32000, \"ano_modelo_texto\": \"Zero Km\", \"combustivel\": \"Gasolina\" }\n]"
        }
      ]
    },
    {
      "name": "Consultar Preços por Marca",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/v1/marcas/:id/precos?limite=10&codigo_tabela_referencia=&cursor=",
          "host": ["{{base_url}}"],
          "path": ["api", "v1", "marcas", ":id", "precos"],
          "query": [
            {
              "key": "limite",
              "value": "10",
              "description": "(Opcional) Itens por página (padrão e máximo: 100)."
            },
            {
              "key": "codigo_tabela_referencia",
              "value": "",
              "description": "(Opcional) Filtrar por um mês de referência específico."
            },
            {
              "key": "cursor",
              "value": "",
              "description": "(Opcional) Cursor da próxima página (proximo_cursor da resposta anterior)."
            }
          ],
          "variable": [
            {
              "key": "id",
              "value": "2",
              "description": "ID da marca."
            }
          ]
        },
        "description": "Retorna os preços de todos os modelos e anos de uma marca específica."
      },
      "response": [
        {
          "name": "200 OK",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/marcas/1/precos?limite=10",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "marcas", "1", "precos"],
              "query": [{ "key": "limite", "value": "10" }]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "{\n  \"dados\": [\n    {\n      \"id\": 3,\n      \"tabela_referencia\": \"junho/2026\",\n      \"codigo_fipe\": \"038003-2\",\n      \"valor\": 10816,\n      \"valor_texto\": \"R$ 10.816,00\",\n      \"marca\": \"Acura\",\n      \"modelo\": \"Integra GS 1.8\",\n      \"ano_modelo\": 1992,\n      \"ano_modelo_texto\": \"1992\",\n      \"combustivel\": \"Gasolina\"\n    }\n  ],\n  \"proximo_cursor\": \"MzM0LjM\"\n}"
        }
      ]
    },
    {
      "name": "Consultar Preços por Modelo",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/v1/modelos/:id/precos?limite=100&codigo_tabela_referencia=&cursor=",
          "host": ["{{base_url}}"],
          "path": ["api", "v1", "modelos", ":id", "precos"],
          "query": [
            {
              "key": "limite",
              "value": "100",
              "description": "(Opcional) Itens por página (padrão e máximo: 100)."
            },
            {
              "key": "codigo_tabela_referencia",
              "value": "",
              "description": "(Opcional) Filtrar por um mês de referência específico."
            },
            {
              "key": "cursor",
              "value": "",
              "description": "(Opcional) Cursor da próxima página (proximo_cursor da resposta anterior)."
            }
          ],
          "variable": [
            {
              "key": "id",
              "value": "2",
              "description": "ID do modelo."
            }
          ]
        },
        "description": "Retorna os preços de todas as variações de ano e combustível de um modelo específico."
      },
      "response": [
        {
          "name": "200 OK",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/modelos/2/precos",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "modelos", "2", "precos"]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "{\n  \"dados\": [\n    {\n      \"id\": 4,\n      \"tabela_referencia\": \"junho/2026\",\n      \"codigo_fipe\": \"038003-2\",\n      \"valor\": 24766,\n      \"valor_texto\": \"R$ 24.766,00\",\n      \"marca\": \"Acura\",\n      \"modelo\": \"Legend 3.2/3.5\",\n      \"ano_modelo\": 1998,\n      \"ano_modelo_texto\": \"1998\",\n      \"combustivel\": \"Gasolina\"\n    }\n  ],\n  \"proximo_cursor\": \"MzM0LjQ\"\n}"
        }
      ]
    },
    {
      "name": "Consultar Preço Específico",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/api/v1/precos/:id_ano_modelo",
          "host": ["{{base_url}}"],
          "path": ["api", "v1", "precos", ":id_ano_modelo"],
          "variable": [
            {
              "key": "id_ano_modelo",
              "value": "5000",
              "description": "ID da combinação modelo+ano (model_year_id)."
            }
          ]
        },
        "description": "Retorna o preço atual e o histórico de avaliações FIPE de um veículo para o ano/combustível."
      },
      "response": [
        {
          "name": "200 OK",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/precos/5000",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "precos", "5000"]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [{ "key": "Content-Type", "value": "application/json" }],
          "body": "[\n  {\n    \"id\": 5000,\n    \"tabela_referencia\": \"junho/2026\",\n    \"codigo_fipe\": \"038001-6\",\n    \"valor\": 39978,\n    \"valor_texto\": \"R$ 39.978,00\",\n    \"marca\": \"Acura\",\n    \"modelo\": \"NSX 3.0\",\n    \"ano_modelo\": 1995,\n    \"ano_modelo_texto\": \"1995\",\n    \"combustivel\": \"Gasolina\"\n  }\n]"
        }
      ]
    }
  ]
}