{"openapi":"3.1.0","info":{"title":"API Placa & FIPE","version":"1.0.0","summary":"Consulta de veículo pela placa com valor da Tabela FIPE do mês.","description":"Placa & FIPE é um serviço brasileiro de consulta de veículo pela placa. Retorna marca, modelo, versão, ano, cor, combustível, município, UF, situação e o valor da Tabela FIPE do mês, em uma única chamada. Pode ser usado direto no site ou integrado por API REST (JSON) e servidor MCP, com documentação feita para assistentes de IA como Claude, Gemini, ChatGPT, Cursor e Google Antigravity.\n\n1 crédito por placa encontrada. Placa não encontrada e erros não consomem crédito. Guia para agentes de IA: https://placaefipe.com.br/guia-ia.md","contact":{"name":"Placa & FIPE","url":"https://placaefipe.com.br","email":"contato@placaefipe.com.br"},"termsOfService":"https://placaefipe.com.br/termos"},"externalDocs":{"description":"Documentação","url":"https://placaefipe.com.br/docs"},"servers":[{"url":"https://api.placaefipe.com.br/v1","description":"Produção"}],"security":[{"bearer":[]},{"apiKey":[]}],"tags":[{"name":"Placas"},{"name":"Conta"}],"paths":{"/placas/{placa}":{"get":{"operationId":"consultarPlaca","tags":["Placas"],"summary":"Consultar veículo e FIPE pela placa","description":"Devolve os dados do veículo e o valor FIPE do mês. Consome 1 crédito só quando o veículo é encontrado.","parameters":[{"name":"placa","in":"path","required":true,"description":"Placa antiga (ABC1234) ou Mercosul (ABC1D23). Traço e espaço são ignorados.","schema":{"type":"string","pattern":"^[A-Za-z]{3}-?[0-9][A-Za-z0-9][0-9]{2}$","example":"INT8C36"}}],"responses":{"200":{"description":"Veículo encontrado.","headers":{"X-Creditos-Restantes":{"schema":{"type":"integer"},"description":"Saldo depois da consulta"},"X-Consulta-Id":{"schema":{"type":"string"},"description":"ID da consulta"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Veiculo"},"example":{"placa":"INT8C36","placa_antiga":"INT8236","marca":"VW","modelo":"CROSSFOX","versao":"CROSSFOX 1.6 Mi Total Flex 8V 5p","ano_fabricacao":2007,"ano_modelo":2007,"cor":"Prata","combustivel":"Alcool / Gasolina","chassi_final":"10137","municipio":"São Leopoldo","uf":"RS","situacao":"Sem restrição","origem":"Nacional","tecnico":{"motor":"1.6","tipo":"Automovel","especie":"Passageiro","segmento":"AU - HATCH PEQUENO","cilindradas":1599,"passageiros":5,"eixos":2},"fipe":{"codigo":"005225-6","marca":"VW - VolksWagen","modelo":"CROSSFOX 1.6 Mi Total Flex 8V 5p","ano_modelo":2007,"combustivel":"Gasolina","valor":28799,"valor_texto":"R$ 28.799,00","referencia":"novembro de 2026","versoes":[]},"consulta":{"id":"cns_7Hq2LmXa9P","creditos_restantes":989,"cobrada":true,"cache":false}}}}},"400":{"description":"placa_invalida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"nao_autenticado ou chave_invalida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"402":{"description":"sem_creditos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"placa_nao_encontrada (não cobra crédito)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"limite_excedido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"indisponivel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/saldo":{"get":{"operationId":"consultarSaldo","tags":["Conta"],"summary":"Créditos restantes","description":"Não consome crédito.","responses":{"200":{"description":"Saldo da conta.","content":{"application/json":{"schema":{"type":"object","properties":{"creditos":{"type":"integer"},"conta":{"type":"object","properties":{"email":{"type":"string"}}}}},"example":{"creditos":989,"conta":{"email":"voce@empresa.com.br"}}}}},"401":{"description":"nao_autenticado ou chave_invalida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Authorization: Bearer pf_live_..."},"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Erro":{"type":"object","required":["erro"],"properties":{"erro":{"type":"object","required":["codigo","mensagem"],"properties":{"codigo":{"type":"string","enum":["nao_autenticado","chave_invalida","placa_invalida","sem_creditos","placa_nao_encontrada","limite_excedido","limite_da_chave","indisponivel","metodo_nao_permitido","erro_interno"]},"mensagem":{"type":"string"},"docs":{"type":"string","format":"uri"}}}}},"Fipe":{"type":["object","null"],"properties":{"codigo":{"type":["string","null"],"description":"Código FIPE"},"marca":{"type":["string","null"],"description":"Marca na FIPE"},"modelo":{"type":["string","null"],"description":"Modelo e versão na FIPE"},"ano_modelo":{"type":["integer","null"],"description":"Ano do modelo"},"combustivel":{"type":["string","null"],"description":"Combustível na FIPE"},"valor":{"type":["number","null"],"description":"Valor em reais"},"valor_texto":{"type":["string","null"],"description":"Valor formatado, ex. R$ 28.799,00"},"referencia":{"type":["string","null"],"description":"Mês de referência"},"versoes":{"type":"array","description":"Versões possíveis quando a placa não define a versão","items":{"type":"object","properties":{"codigo":{"type":"string"},"modelo":{"type":"string"},"valor":{"type":["number","null"]},"valor_texto":{"type":["string","null"]}}}}}},"Veiculo":{"type":"object","required":["placa","consulta"],"properties":{"placa":{"type":"string","description":"Placa no padrão Mercosul"},"placa_antiga":{"type":["string","null"],"description":"Placa no padrão antigo"},"marca":{"type":["string","null"],"description":"Marca"},"modelo":{"type":["string","null"],"description":"Modelo"},"versao":{"type":["string","null"],"description":"Versão mais provável"},"ano_fabricacao":{"type":["integer","null"],"description":"Ano de fabricação"},"ano_modelo":{"type":["integer","null"],"description":"Ano do modelo"},"cor":{"type":["string","null"],"description":"Cor"},"combustivel":{"type":["string","null"],"description":"Combustível no registro"},"chassi_final":{"type":["string","null"],"description":"Últimos 5 caracteres do chassi"},"municipio":{"type":["string","null"],"description":"Município de registro"},"uf":{"type":["string","null"],"description":"UF de registro"},"situacao":{"type":["string","null"],"description":"Situação do veículo"},"origem":{"type":["string","null"],"description":"Nacional ou Importado"},"tecnico":{"type":"object","properties":{"motor":{"type":["string","null"],"description":"Motorização em litros, ex. 1.6"},"tipo":{"type":["string","null"],"description":"Tipo de veículo"},"especie":{"type":["string","null"],"description":"Espécie"},"segmento":{"type":["string","null"],"description":"Segmento"},"cilindradas":{"type":["number","null"],"description":"Cilindrada (cm³)"},"passageiros":{"type":["number","null"],"description":"Lotação"},"eixos":{"type":["number","null"],"description":"Eixos"}}},"fipe":{"$ref":"#/components/schemas/Fipe"},"consulta":{"type":"object","properties":{"id":{"type":"string"},"creditos_restantes":{"type":"integer"},"cobrada":{"type":"boolean"},"cache":{"type":"boolean"}}}}}}}}