Sobre esta API

Cadastro do veículo a partir da placa: marca, modelo, versão, ano de fabricação e ano-modelo, cor, combustível, categoria, município e UF de registro e o indicador de roubo ou furto — com o preço na tabela FIPE do mês na mesma resposta.

Envie a placa em plate, no padrão antigo (ABC1234) ou Mercosul (ABC1D23), com ou sem hífen. Placa fora do padrão volta 400 e não é cobrada.

Placa válida sem cadastro volta com found: false e é cobrada: a consulta foi feita. Não traz dados do proprietário, chassi nem RENAVAM.

Fonte dos dados

Cadastro de veículos e tabela FIPE · Atualização: tempo real

Requisição

GET /api/v1/vehicle/plate

Autenticação HTTP Basic: public_key:secret_key em Base64. Guarde a chave secreta no servidor.

Cabeçalho	Descrição
`Authorization` Obrigatório	Chave de API em Basic: `public_key:secret_key` em Base64.
`X-Project-Id` Opcional	Projeto que recebe a chamada. Sem ele, vale o projeto padrão da conta.
`Idempotency-Key` Opcional	Repetir a mesma chave em até 24 horas devolve a resposta anterior, sem executar nem cobrar de novo.

Parâmetros

Campo	Tipo e local	Descrição
`plate` Obrigatório	stringquery	Padrão antigo ou Mercosul, com ou sem hífen. Exemplo: `ABC1D23`

1curl --request GET 'https://api.apifordevs.com/api/v1/vehicle/plate?plate=ABC1D23' \
2  --user "afd_live_pk_...:$AFD_SECRET_KEY" \
3  --header "X-Project-Id: $AFD_PROJECT_ID"

1import os
2import requests
3
4response = requests.request(
5    "GET",
6    "https://api.apifordevs.com/api/v1/vehicle/plate?plate=ABC1D23",
7    auth=("afd_live_pk_...", os.environ["AFD_SECRET_KEY"]),
8    headers={"X-Project-Id": os.environ["AFD_PROJECT_ID"]},
9    timeout=30,
10)
11response.raise_for_status()
12print(response.json())

1const response = await fetch("https://api.apifordevs.com/api/v1/vehicle/plate?plate=ABC1D23", {
2  method: "GET",
3  headers: {
4    Authorization: "Basic " + Buffer.from(
5      "afd_live_pk_...:" + process.env.AFD_SECRET_KEY
6    ).toString("base64"),
7    "X-Project-Id": process.env.AFD_PROJECT_ID,
8  },
9  signal: AbortSignal.timeout(30000),
10});
11if (!response.ok) throw new Error(`HTTP ${response.status}`);
12console.log(await response.json());

Campos de resposta

Campos e tipos publicados no catálogo desta API.

Encontradofoundboolean
Placaplatestring
Veículovehicleobject
Marcavehicle.brandstring
Modelovehicle.modelstring
Versãovehicle.versionstring
Ano de fabricaçãovehicle.manufacture_yearinteger
Ano-modelovehicle.model_yearinteger
Corvehicle.colorstring
Combustívelvehicle.fuelstring
Categoriavehicle.categorystring
Municípiovehicle.citystring

Exemplo de resposta

1{
2  "success": true,
3  "code": 200,
4  "code_message": "A requisição foi processada com sucesso.",
5  "errors": [],
6  "header": null,
7  "data_count": 1,
8  "data": [
9    {
10      "found": true,
11      "plate": "ABC1D23",
12      "vehicle": {
13        "brand": "FIAT",
14        "model": "ARGO",
15        "version": "1.0 6V FLEX",
16        "manufacture_year": 2018,
17        "model_year": 2018,
18        "color": "PRATA",
19        "fuel": "FLEX",
20        "category": "AUTOMOVEL",
21        "city": "SAO PAULO",
22        "state": "SP",
23        "theft_record": false,
24        "fipe_code": "001509-1"
25      },
26      "fipe": {
27        "vehicle_type": "cars",
28        "fipe_code": "001509-1",
29        "brand": "Fiat",
30        "model": "ARGO 1.0 6V Flex",
31        "model_year": 2018,
32        "zero_km": false,
33        "fuel": "Flex",
34        "fuel_acronym": "F",
35        "price": "R$ 48.093,00",
36        "price_value": "48093.00",
37        "reference_month": "outubro de 2026"
38      }
39    }
40  ]
41}

Respostas e cobrança

HTTP	Descrição	Cobrança
`200`	Sucesso. Placa sem cadastro também é `200`, com `found: false`, e é cobrada.	Sujeita à cobrança
`400` `bad_request`	Placa fora do padrão antigo ou Mercosul. Não é cobrada.	Sem cobrança
`401` `unauthorized`	Credencial ausente, inválida ou revogada.	Sem cobrança
`402` `payment_required`	Saldo insuficiente ou limite de gasto diário atingido.	Sem cobrança
`403` `forbidden` `ip_not_allowed` `test_key_cannot_run_live`	E-mail da conta não verificado, chave sem escopo para o serviço, IP fora da allowlist do projeto ou chave de teste sem `dev_mode=true`.	Sem cobrança
`409` `conflict`	Requisição com a mesma `Idempotency-Key` ainda em andamento.	Sem cobrança
`422` `validation_error`	Parâmetro obrigatório ausente ou fora do formato, ou `Idempotency-Key` repetida com outro conteúdo.	Sem cobrança
`429` `rate_limit_exceeded`	Limite de requisições por minuto da chave atingido.	Sem cobrança
`500` `internal_error`	Falha interna.	Sem cobrança
`503` `service_unavailable` `upstream_error`	Serviço desativado (`service_unavailable`), ou a consulta da placa não respondeu a tempo (`upstream_error`). Não é cobrada; com `upstream_error`, pode ser repetida.	Sem cobrança

Casos de uso

Cotação de seguro pela placa

O cliente digita a placa e a cotação já sai com modelo, ano e valor FIPE, sem formulário de marca e modelo.

Antifraude em compra e venda

Conferir se o anúncio bate com o cadastro da placa e se há registro de roubo ou furto antes de fechar negócio.

Garantia de crédito

Avaliar o veículo dado em garantia pelo preço FIPE do mês.

Consulta de veículo por placa