Skip to main content
POST
Crear consulta vehicular
La Consulta Vehicular devuelve la ficha de un vehículo registrado en SUNARP a partir de su placa: marca, modelo, año, color, número de serie, VIN, motor, sede registral, estado, anotaciones y propietarios, junto con la imagen del documento. Es un proceso en dos pasos:
  1. POST con la placa → respuesta 202 con un task_id.
  2. Obtener resultado con ese task_id hasta que el estado deje de ser pending.

Cuándo usar este endpoint

SUNARP atiende un número limitado de consultas por minuto y cada una puede tardar varios segundos. Este endpoint acepta tus placas de inmediato, sin importar cuántas envíes de golpe, y las resuelve por detrás a ritmo controlado y con reintentos automáticos. Una consulta suelta suele resolverse en menos de 30 segundos; en un lote, el tiempo total depende del ritmo de la fuente.
La ruta síncrona POST /v2/consulta/vehicular está deprecada. Sigue respondiendo para las integraciones existentes, pero dejará de hacerlo en una fecha que comunicaremos con anticipación. Migra a este flujo en dos pasos.

Autenticación

¿Todavía no tienes un API token? El campo Authorization del panel Try it espera tu token Bearer. Revisa dónde obtener tu API token para conseguirlo.
Este endpoint requiere autenticación Bearer. Incluye tu API key en el header Authorization (si aún no sabes cómo obtener y usar tu API key, consulta la página de Autenticación):

Atributos Requeridos

string
required
Placa del vehículo. Exactamente 6 caracteres alfanuméricos, sin guion (por ejemplo B7K512).

Respuesta

string
success cuando la consulta fue aceptada.
string
Mensaje descriptivo.
object

Ejemplo de Solicitud

Ejemplo de Respuesta

Consumo de cuota

Cada consulta descuenta 1 de tu cuota de Consulta Vehicular al ser aceptada (respuesta 202). Los headers X-Quota-Limit y X-Quota-Remaining de esa respuesta traen tu cuota total y la restante.

Códigos de Error