Documentação da API

Informações da API

Base URL: http://apiplaca.fipeapi.site

Endpoint principal: POST /api/v1/consulta-placa

Endpoint demo: POST /api/v1/demo/consulta-placa 3 consultas grátis

Provedor: apiws.net • Módulo: veicularCompleto

Autenticação

Para usar a API, você precisa incluir seu token no header de autorização:

Authorization: Bearer SEU_TOKEN_AQUI

Parâmetros da Requisição

Parâmetro Tipo Obrigatório Descrição
placa string Sim Placa do veículo (ex: ABC1234)

Resposta de Sucesso (200)

{
  "ok": true,
  "data": {
    "placa": "ABC1234",
    "marca": "VOLKSWAGEN",
    "modelo": "GOL",
    "ano": "2020",
    "cor": "PRATA",
    "chassi": "9BWAA05U...",
    "renavam": "00123456789",
    // ... outros dados
  },
  "meta": {
    "token_prefix": "abcd1234",
    "expires_at": "2026-04-12T23:59:59-03:00"
  }
}

Respostas de Erro

401 Unauthorized - Token inválido ou expirado

{ "error": "Token inválido ou expirado" }

400 Bad Request - Parâmetro placa ausente

{ "error": "Placa obrigatória" }

Exemplos de Código

curl -X POST \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data "placa=ABC1234" \
  http://apiplaca.fipeapi.site/api/v1/consulta-placa
fetch('http://apiplaca.fipeapi.site/api/v1/consulta-placa', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SEU_TOKEN',
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams({ placa: 'ABC1234' })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Erro:', error));
$ch = curl_init('http://apiplaca.fipeapi.site/api/v1/consulta-placa');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query(['placa' => 'ABC1234']),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer SEU_TOKEN',
        'Content-Type: application/x-www-form-urlencoded'
    ]
]);
$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

if ($data['ok']) {
    echo "Veículo: " . $data['data']['marca'] . " " . $data['data']['modelo'];
} else {
    echo "Erro: " . $data['error'];
}
import requests

url = 'http://apiplaca.fipeapi.site/api/v1/consulta-placa'
headers = {
    'Authorization': 'Bearer SEU_TOKEN',
    'Content-Type': 'application/x-www-form-urlencoded'
}
data = {'placa': 'ABC1234'}

response = requests.post(url, headers=headers, data=data)
result = response.json()

if result.get('ok'):
    veiculo = result['data']
    print(f"Veículo: {veiculo['marca']} {veiculo['modelo']}")
else:
    print(f"Erro: {result.get('error')}")
const axios = require('axios');

const url = 'http://apiplaca.fipeapi.site/api/v1/consulta-placa';
const headers = {
  'Authorization': 'Bearer SEU_TOKEN',
  'Content-Type': 'application/x-www-form-urlencoded'
};
const data = new URLSearchParams({ placa: 'ABC1234' });

axios.post(url, data, { headers })
  .then(response => {
    if (response.data.ok) {
      console.log('Veículo:', response.data.data);
    }
  })
  .catch(error => {
    console.error('Erro:', error.response?.data || error.message);
  });