Skip to main content
POST
Crear consulta VIN (asíncrona)

Cuándo usar este endpoint

La fuente registral (SUNARP) atiende un número limitado de consultas por minuto. Este endpoint acepta tus VINs de inmediato, sin importar cuántos envíes de golpe, y los resuelve por detrás a ritmo controlado y con reintentos automáticos. Es el único flujo de consulta por VIN: sirve igual para un VIN suelto que para un lote. El flujo tiene dos pasos:
  1. POST con el VIN → respuesta 202 con un task_id.
  2. GET /api/v1/solutions/consulta/vehicular-vin/{task_id} hasta que el estado deje de ser pending, o recibe el resultado en tu webhook si tienes uno configurado.

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.

Atributos Requeridos

string
required
Número de identificación del vehículo (VIN). 17 caracteres alfanuméricos, sin las letras I, O ni Q (ISO 3779). Se normaliza a mayúsculas.

Respuesta

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

Ejemplo de Solicitud

Ejemplo de Respuesta

Cuota

Cada consulta aceptada descuenta 1 de tu cuota de consulta vehicular en el momento del 202.

Códigos de Error