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

> Crea una consulta asíncrona de placas a partir de un número de VIN

## Autenticación

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](/api-reference/authentication)):

```
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).
</ParamField>

<Info>
  El **formato del VIN se valida de forma síncrona**: si no cumple, la API responde `422` de inmediato y la consulta **no se encola**. Si es válido, responde `202` con un `task_id` que usarás para hacer polling del resultado en [Consultar respuesta](/api-reference/vin/get-vin-query).
</Info>

## Respuesta

<ResponseField name="status" type="string">
  Resultado de negocio: `success` o `error`. En este endpoint una validación fallida devuelve `success` con el detalle en `errors`.
</ResponseField>

<ResponseField name="message" type="string">
  Mensaje legible del resultado.
</ResponseField>

<ResponseField name="data" type="object | null">
  Carga útil de la respuesta.

  <Expandable title="propiedades de data">
    <ResponseField name="task_id" type="string">
      Identificador de la tarea asíncrona. Úsalo para consultar el resultado por polling o para correlacionar la entrega por webhook.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="errors" type="object">
  Solo presente en validación (`422`): mapa `campo → [mensajes]`, formato Laravel.
</ResponseField>

## Ejemplo de Solicitud

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

## Ejemplo de Respuesta Exitosa

Respuesta `202` (aceptada): el VIN es válido y la consulta quedó en proceso.

```json theme={null}
{
  "status": "success",
  "message": "Consulta recibida y en proceso.",
  "data": {
    "task_id": "a1b2c3d4-..."
  }
}
```

## Ejemplo de Respuesta de Validación

Respuesta `422`: el VIN no cumple el formato. La consulta no se encola.

```json theme={null}
{
  "status": "success",
  "errors": {
    "vin": [
      "The vin field is required."
    ]
  }
}
```

## Códigos de Error

| Código | Descripción                                                                                                               |
| ------ | ------------------------------------------------------------------------------------------------------------------------- |
| 401    | Token de autenticación inválido o faltante                                                                                |
| 422    | Validación del VIN: el campo `vin` es requerido o no cumple el formato (17 alfanuméricos, sin I/O/Q). Detalle en `errors` |