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

> Encola la consulta de un vehículo por su placa y devuelve un task_id.

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](https://developers.verifica.id/api-reference/vehicle/get-vehicle-query.md) 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.

> [!WARNING]
>
> 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

> [!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.

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](https://developers.verifica.id/api-reference/authentication.md)):

```
Authorization: Bearer YOUR_API_KEY
```

## Atributos Requeridos

**plate** `string` *required*

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

## 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 [Obtener resultado](https://developers.verifica.id/api-reference/vehicle/get-vehicle-query.md).

## Ejemplo de Solicitud

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

## Ejemplo de Respuesta

```json theme={null}
{
  "status": "success",
  "message": "Consulta recibida y en proceso.",
  "data": {
    "task_id": "01a17d31-e5ef-7aa1-9c3b-2f6d8e4a1b70"
  }
}
```

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

| Código | Descripción |
| - | - |
| 401 | Token de autenticación inválido o faltante |
| 402 | No tienes cuota disponible de Consulta Vehicular |
| 422 | El campo `plate` es requerido o no tiene 6 caracteres alfanuméricos. Detalle en `errors` |
| 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.