Consulta Placa

Ficha técnica de un vehículo a partir de su placa.

Consideraciones

Devuelve la ficha técnica del vehículo (marca, modelo, año, clase, VIN…) a partir de su placa (fuente Pacífico).
No disponible en el plan gratuito.
Consume 2 consultas de tu plan.

POST https://api.apiperu.dev/placa Copiar

Headers

Name	Type	Description
Accept	String	application/json
Content-Type	string	application/json
Authorization	string	Bearer <token>. Genéralo desde tu panel, en `Api Tokens`.

Body

Name	Type	Description
placa*	string	Placa del vehículo (6 a 7 caracteres alfanuméricos). Ejemplo: `ABC123`.

Ejemplo de solicitud

Copiar

# https://apiperu.dev también funciona (dominio legacy) anteponiendo /api a la ruta — ver Inicio
URL_BASE="https://api.apiperu.dev"

curl -X POST "$URL_BASE/placa" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"placa":"ABC123"}'

Copiar

<?php

// https://apiperu.dev también funciona (dominio legacy) anteponiendo /api a la ruta — ver Inicio
$urlBase = 'https://api.apiperu.dev';

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => $urlBase . '/placa',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'placa' => 'ABC123',
    ]),
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer TU_TOKEN',
        'Content-Type: application/json',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

Copiar

// https://apiperu.dev también funciona (dominio legacy) anteponiendo /api a la ruta — ver Inicio
const URL_BASE = 'https://api.apiperu.dev';

const response = await fetch(`${URL_BASE}/placa`, {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer TU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    placa: 'ABC123',
  }),
});

const data = await response.json();
console.log(data);

Copiar

import requests

# https://apiperu.dev también funciona (dominio legacy) anteponiendo /api a la ruta — ver Inicio
URL_BASE = 'https://api.apiperu.dev'

response = requests.post(
    f'{URL_BASE}/placa',
    headers={
        'Accept': 'application/json',
        'Authorization': 'Bearer TU_TOKEN',
        'Content-Type': 'application/json',
    },
    json={
        'placa': 'ABC123',
    },
)

print(response.json())

Respuesta

200 OK application/json

{
  "success": true,
  "code": "found",
  "retryable": false,
  "data": {
    "placa": "ABC123",
    "anio": "2019",
    "marca": "TOYOTA",
    "modelo": "YARIS",
    "tipo_vehiculo": "AUTOMOVIL",
    "clase_vehiculo": "M1",
    "numero_asientos": 5,
    "vin": "8XA1234567890",
    "categoria_mtc": "M1"
  },
  "time": 0.8
}

400 Solicitud inválida application/json

{
  "success": false,
  "code": "invalid_input",
  "retryable": false,
  "message": "El formato de la placa no es válido."
}

404 No encontrado application/json

{
  "success": false,
  "code": "document_not_found",
  "retryable": false,
  "message": "No se encontró información para la placa indicada."
}

503 Servicio no disponible application/json

{
  "success": false,
  "code": "upstream_unavailable",
  "retryable": true,
  "message": "El servicio de consulta no está disponible en este momento. Intenta nuevamente en unos segundos."
}