> ## 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](/api-reference/authentication#dónde-obtener-tu-api-token) para conseguirlo.
</Note>

```
Authorization: Bearer YOUR_API_KEY
```

## Atributos Requeridos

<ParamField body="vin" type="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.
</ParamField>

## Respuesta

<ResponseField name="status" type="string">
  `success` cuando la consulta fue aceptada.
</ResponseField>

<ResponseField name="message" type="string">
  Mensaje descriptivo.
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="propiedades de data">
    <ResponseField name="task_id" type="string">
      Identificador de la consulta (UUID). Úsalo en el `GET` de resultado.
    </ResponseField>
  </Expandable>
</ResponseField>

## Ejemplo de Solicitud

```bash theme={null}
curl --request POST \
  --url https://prd-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.