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

# Consulta Vehicular

> Consulta la información de un vehículo a partir de su número de placa

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

Número de placa del vehículo a consultar

## Respuesta

**type** `string`

Tipo de respuesta (ej: "result")

**status** `integer`

Código de estado HTTP de la respuesta (ej: 200)

**message** `string`

Mensaje descriptivo del resultado de la validación

**data** `object`

Datos del vehículo consultado

**propiedades de data**

**license\_plate\_number** `string`

Número de placa del vehículo

**serial\_number** `string`

Número de serie del vehículo

**vin\_number** `string`

Número de identificación del vehículo (VIN)

**engine\_number** `string`

Número de motor

**color** `string`

Color del vehículo

**make** `string`

Marca del vehículo

**model** `string`

Modelo del vehículo

**current\_license\_plate** `string`

Placa actual del vehículo

**previous\_license\_plate** `string`

Placa anterior del vehículo (ej: "NINGUNA")

**status** `string`

Estado del vehículo (ej: "EN CIRCULACION")

**annotations** `string`

Anotaciones registradas (ej: "NINGUNA")

**registration\_office** `string`

Oficina registral

**model\_year** `string`

Año del modelo

**owners** `array`

Lista de propietarios del vehículo

**file\_url** `string`

URL firmada para descargar el documento del vehículo

## Ejemplo de Solicitud

```bash theme={null}
curl --request POST \
  --url https://api.verifica.id/v2/consulta/vehicular \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {TU-API-KEY}' \
  --header 'content-type: multipart/form-data' \
  --form plate=B7K512
```

## Ejemplo de Respuesta Exitosa

```json theme={null}
{
  "type": "result",
  "status": 200,
  "message": "Se ha validado la información correctamente.",
  "data": {
    "license_plate_number": "B7K512",
    "serial_number": "KMHJT81BADU112233",
    "vin_number": "KMHJT81BADU112233",
    "engine_number": "G4KDDU019284",
    "color": "GRIS OSCURO",
    "make": "HYUNDAI",
    "model": "TUCSON",
    "current_license_plate": "B7K512",
    "previous_license_plate": "NINGUNA",
    "status": "EN CIRCULACION",
    "annotations": "NINGUNA",
    "registration_office": "HUANUCO",
    "model_year": "2013",
    "owners": [
      "RAMIREZ TORRES, CARLOS ENRIQUE"
    ],
    "file_url": "https://docs-mintlify-assets.s3.us-east-1.amazonaws.com/placa-fake.jpg"
  }
}
```

## Códigos de Error

| Código | Descripción |
| - | - |
| 400 | Solicitud inválida - el campo `plate` es requerido o tiene un formato incorrecto |
| 401 | Token de autenticación inválido o faltante |
| 429 | Demasiadas solicitudes - se ha excedido el límite de rate |
| 500 | Error interno del servidor |


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