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

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="plate" type="string" required>
  Número de placa del vehículo a consultar
</ParamField>

## Respuesta

<ResponseField name="type" type="string">
  Tipo de respuesta (ej: "result")
</ResponseField>

<ResponseField name="status" type="integer">
  Código de estado HTTP de la respuesta (ej: 200)
</ResponseField>

<ResponseField name="message" type="string">
  Mensaje descriptivo del resultado de la validación
</ResponseField>

<ResponseField name="data" type="object">
  Datos del vehículo consultado

  <Expandable title="propiedades de data">
    <ResponseField name="license_plate_number" type="string">
      Número de placa del vehículo
    </ResponseField>

    <ResponseField name="serial_number" type="string">
      Número de serie del vehículo
    </ResponseField>

    <ResponseField name="vin_number" type="string">
      Número de identificación del vehículo (VIN)
    </ResponseField>

    <ResponseField name="engine_number" type="string">
      Número de motor
    </ResponseField>

    <ResponseField name="color" type="string">
      Color del vehículo
    </ResponseField>

    <ResponseField name="make" type="string">
      Marca del vehículo
    </ResponseField>

    <ResponseField name="model" type="string">
      Modelo del vehículo
    </ResponseField>

    <ResponseField name="current_license_plate" type="string">
      Placa actual del vehículo
    </ResponseField>

    <ResponseField name="previous_license_plate" type="string">
      Placa anterior del vehículo (ej: "NINGUNA")
    </ResponseField>

    <ResponseField name="status" type="string">
      Estado del vehículo (ej: "EN CIRCULACION")
    </ResponseField>

    <ResponseField name="annotations" type="string">
      Anotaciones registradas (ej: "NINGUNA")
    </ResponseField>

    <ResponseField name="registration_office" type="string">
      Oficina registral
    </ResponseField>

    <ResponseField name="model_year" type="string">
      Año del modelo
    </ResponseField>

    <ResponseField name="owners" type="array">
      Lista de propietarios del vehículo
    </ResponseField>

    <ResponseField name="file_url" type="string">
      URL firmada para descargar el documento del vehículo
    </ResponseField>
  </Expandable>
</ResponseField>

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