> ## Documentation Index
> Fetch the complete documentation index at: https://developers.verifica.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear consulta VIN (asíncrona)

> Encola la consulta de placas por VIN y devuelve un task_id. Recomendada para lotes.

## 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

> [!NOTE]
>
> **¿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](https://developers.verifica.id/api-reference/authentication.md#dónde-obtener-tu-api-token) para conseguirlo.

```
Authorization: Bearer YOUR_API_KEY
```

## Atributos Requeridos

**vin** `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

**status** `string`

`success` cuando la consulta fue aceptada.

**message** `string`

Mensaje descriptivo.

**data** `object`

**propiedades de data**

**task\_id** `string`

Identificador de la consulta (UUID). Úsalo en el `GET` de resultado.

## Ejemplo de Solicitud

```bash theme={null}
curl --request POST \
  --url https://api.verifica.id/api/v1/solutions/consulta/vehicular-vin \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {TU-API-KEY}' \
  --data '{"vin": "1HGCM82633A004352"}'
```

## Ejemplo de Respuesta

```json theme={null}
{
  "status": "success",
  "message": "Consulta recibida y en proceso.",
  "data": {
    "task_id": "9c1d2f6e-3b7a-4e0d-9f21-6a5c0b8d1e42"
  }
}
```

## Cuota

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

## Códigos de Error

| Código | Descripción |
| - | - |
| 401 | Token de autenticación inválido o faltante |
| 402 | Sin cuota disponible para atender la petición |
| 422 | El campo `vin` es requerido o no cumple el formato (17 alfanuméricos, sin I, O ni Q) |
| 429 | Demasiadas solicitudes - se ha excedido el límite de rate |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.