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

# Boleta Informativa

> Obtén la boleta informativa SUNARP 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 de la boleta informativa del vehículo

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

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

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

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

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

    <ResponseField name="color_2" type="string | null">
      Color secundario del vehículo
    </ResponseField>

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

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

    <ResponseField name="placa_vigente" type="string">
      Placa vigente del vehículo
    </ResponseField>

    <ResponseField name="placa_anterior" type="string | null">
      Placa anterior del vehículo
    </ResponseField>

    <ResponseField name="sede" type="string">
      Sede registral
    </ResponseField>

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

    <ResponseField name="ano_fabricacion" type="string">
      Año de fabricación
    </ResponseField>

    <ResponseField name="tipo_uso" type="string">
      Tipo de uso del vehículo
    </ResponseField>

    <ResponseField name="categoria" type="string">
      Categoría del vehículo (ej: "N1")
    </ResponseField>

    <ResponseField name="carroceria" type="string">
      Tipo de carrocería (ej: "PICK UP")
    </ResponseField>

    <ResponseField name="tipo_combustible" type="string">
      Tipo de combustible (ej: "DIESEL")
    </ResponseField>

    <ResponseField name="potencia_motor" type="string">
      Potencia del motor
    </ResponseField>

    <ResponseField name="nro_cilindros" type="integer">
      Número de cilindros
    </ResponseField>

    <ResponseField name="cilindrada" type="string">
      Cilindrada del motor
    </ResponseField>

    <ResponseField name="version" type="string">
      Versión del vehículo
    </ResponseField>

    <ResponseField name="peso_neto" type="string">
      Peso neto del vehículo
    </ResponseField>

    <ResponseField name="peso_bruto" type="string">
      Peso bruto del vehículo
    </ResponseField>

    <ResponseField name="carga_util" type="string">
      Carga útil del vehículo
    </ResponseField>

    <ResponseField name="nro_asientos" type="integer">
      Número de asientos
    </ResponseField>

    <ResponseField name="nro_pasajeros" type="integer">
      Número de pasajeros
    </ResponseField>

    <ResponseField name="nro_ejes" type="integer">
      Número de ejes
    </ResponseField>

    <ResponseField name="nro_ruedas" type="integer">
      Número de ruedas
    </ResponseField>

    <ResponseField name="longitud" type="string">
      Longitud del vehículo
    </ResponseField>

    <ResponseField name="ancho" type="string">
      Ancho del vehículo
    </ResponseField>

    <ResponseField name="altura" type="string">
      Altura del vehículo
    </ResponseField>

    <ResponseField name="formato_rodante" type="string">
      Formato rodante (ej: "4X2")
    </ResponseField>

    <ResponseField name="fecha_inmatriculacion" type="string">
      Fecha de inmatriculación (formato YYYY-MM-DD)
    </ResponseField>

    <ResponseField name="fecha_propiedad" type="string | null">
      Fecha de propiedad (formato YYYY-MM-DD)
    </ResponseField>

    <ResponseField name="condicion" type="string">
      Condición del vehículo
    </ResponseField>

    <ResponseField name="nro_partida" type="string">
      Número de partida registral
    </ResponseField>

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

      <Expandable title="propiedades de propietarios">
        <ResponseField name="nombre" type="string">
          Nombre o razón social del propietario
        </ResponseField>

        <ResponseField name="tipo_documento" type="string | null">
          Tipo de documento del propietario
        </ResponseField>

        <ResponseField name="numero_documento" type="string | null">
          Número de documento del propietario
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="afectaciones" type="array">
      Lista de afectaciones registradas sobre el vehículo
    </ResponseField>

    <ResponseField name="file_url" type="string">
      URL firmada para descargar la boleta informativa
    </ResponseField>
  </Expandable>
</ResponseField>

## Ejemplo de Solicitud

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

## Ejemplo de Respuesta Exitosa

```json theme={null}
{
  "type": "result",
  "status": 200,
  "message": "Se ha validado la información correctamente.",
  "data": {
    "n_placa": "C4T618",
    "n_serie": "JN1AHGD22AX112233",
    "n_vin": "JN1AHGD22AX112233",
    "n_motor": "TD27000111",
    "color": "AZUL OSCURO PERLADO",
    "color_2": null,
    "marca": "NISSAN",
    "modelo": "FRONTIER",
    "placa_vigente": "C4T618",
    "placa_anterior": null,
    "sede": "OFICINA LIMA",
    "ano_modelo": "2010",
    "ano_fabricacion": "2010",
    "tipo_uso": "N-Motorizados para transporte de mercancias",
    "categoria": "N1",
    "carroceria": "PICK UP",
    "tipo_combustible": "DIESEL",
    "potencia_motor": "62.66@4300",
    "nro_cilindros": 4,
    "cilindrada": "2.664 L",
    "version": "4X2 C/S STD 2.7",
    "peso_neto": "1.465 tn",
    "peso_bruto": "2.57 tn",
    "carga_util": "1.105 tn",
    "nro_asientos": 2,
    "nro_pasajeros": 2,
    "nro_ejes": 2,
    "nro_ruedas": 4,
    "longitud": "5.17 mt",
    "ancho": "1.69 mt",
    "altura": "1.61 mt",
    "formato_rodante": "4X2",
    "fecha_inmatriculacion": "2010-07-15",
    "fecha_propiedad": null,
    "condicion": "SIN DEFINIR",
    "nro_partida": "50001234",
    "propietarios": [
      {
        "nombre": "IMPORTACIONES ANDINAS S.A.",
        "tipo_documento": null,
        "numero_documento": null
      }
    ],
    "afectaciones": [],
    "file_url": "https://docs-mintlify-assets.s3.us-east-1.amazonaws.com/fake-boleta-informativa.pdf"
  }
}
```

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