# API de Placa e FIPE: início rápido

A API do **Placa & FIPE** recebe a placa de um veículo brasileiro e devolve, em um JSON padronizado, **marca, modelo, versão, ano, cor, combustível, município, UF, situação e o valor da Tabela FIPE do mês**.

- **URL base:** `https://api.placaefipe.com.br/v1`
- **Formato:** JSON (UTF-8), nomes de campos em `snake_case` e português
- **Autenticação:** `Authorization: Bearer pf_live_...`
- **Preço:** 1 crédito por placa encontrada. Placa não encontrada não é cobrada.
- **Grátis:** 10 consultas ao criar a conta, sem cartão.

> Usa Claude Code, Cursor, Gemini CLI ou Google Antigravity? Copie as instruções prontas em [Integração com IA](/docs/ia) e deixe a IA fazer a integração.

## 1. Crie a conta e gere a chave

1. Crie a conta em [placaefipe.com.br/criar-conta](https://placaefipe.com.br/criar-conta).
2. No [painel](https://placaefipe.com.br/painel), clique em **Gerar chave de API**.
3. Guarde a chave numa variável de ambiente do servidor:

```bash
PLACAEFIPE_API_KEY=pf_live_sua_chave_aqui
```

A chave aparece inteira **uma única vez**. Se perder, gere outra e revogue a antiga.

## 2. Faça a primeira consulta

```bash
curl https://api.placaefipe.com.br/v1/placas/INT8C36 \
  -H "Authorization: Bearer $PLACAEFIPE_API_KEY"
```

## 3. Leia a resposta

```json
{
  "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",
  "municipio": "São Leopoldo",
  "uf": "RS",
  "situacao": "Sem restrição",
  "fipe": {
    "codigo": "005225-6",
    "valor": 28799.0,
    "valor_texto": "R$ 28.799,00",
    "referencia": "novembro de 2026",
    "versoes": []
  },
  "consulta": { "id": "cns_7Hq2LmXa9P", "creditos_restantes": 989, "cobrada": true, "cache": false }
}
```

A resposta completa, campo a campo, está em [Consultar placa](/docs/consultar-placa).

## Regras importantes

- **Chame a API só do seu servidor** (backend, rota de API, edge function). Nunca coloque a chave no front-end, no app ou no repositório.
- **Não há dados do proprietário.** Nome, CPF e endereço do dono não são retornados (LGPD).
- **A FIPE vem sempre que existir.** Quando a placa não define a versão exata, `fipe.versoes` traz a lista de versões com o valor de cada uma. Veja [FIPE](/docs/fipe).

## Próximos passos

- [Autenticação](/docs/autenticacao): formatos aceitos da chave e boas práticas.
- [Exemplos de código](/docs/exemplos): Node.js, Next.js, Python, PHP, Go e n8n.
- [Servidor MCP](/docs/mcp): use a consulta direto no Claude, Cursor, Gemini e Antigravity.
- [Erros](/docs/erros): todos os códigos e o que fazer em cada um.
- [OpenAPI](/docs/openapi): especificação para gerar clientes e importar no Postman.