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

# Obtener resultado de consulta vehicular

> Consulta el estado y la ficha del vehículo de una consulta por su task_id

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

```
Authorization: Bearer YOUR_API_KEY
```

## Parámetros de Ruta

**task\_id** `string` *required*

Identificador devuelto por [Crear consulta](https://developers.verifica.id/api-reference/vehicle/create-vehicle-query.md) (UUID).

## Estados

El código HTTP indica en qué punto está la consulta:

| HTTP | `status` | Significado |
| - | - | - |
| 202 | `pending` | Aún en proceso. Incluye los reintentos automáticos contra SUNARP; vuelve a consultar en unos segundos |
| 200 | `success` | Resuelta. `data` trae la ficha del vehículo. Si la placa no existe en SUNARP, `data` es `null` y `message` es `Sin resultados para la búsqueda.` |
| 503 | `error` | SUNARP no estuvo disponible tras todos los reintentos. Puedes crear una consulta nueva |
| 500 | `error` | Error interno al procesar la consulta |

Consultar el resultado no consume cuota. Solo la organización que creó la consulta puede leerla: un `task_id` desconocido o de otra organización responde `200` con `data` en `null` y el mensaje `Consulta no encontrada.`.

## Respuesta

**status** `string`

`pending`, `success` o `error`.

**message** `string`

Mensaje descriptivo del estado.

**data** `object | null`

Solo cuando la consulta se resolvió con resultado.

**propiedades de data**

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

Placa consultada.

**serial\_number** `string`

Número de serie del vehículo.

**vin\_number** `string`

Número VIN.

**engine\_number** `string`

Número de motor.

**color** `string`

Color.

**make** `string`

Marca.

**model** `string`

Modelo.

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

Placa vigente.

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

Placa anterior, o `NINGUNA`.

**status** `string`

Estado del vehículo (por ejemplo `EN CIRCULACION`).

**annotations** `string`

Anotaciones, o `NINGUNA`.

**registration\_office** `string`

Sede registral.

**model\_year** `string`

Año de modelo.

**owners** `array`

Propietarios registrados, como `APELLIDOS, NOMBRES`.

**file\_url** `string`

URL temporal a la imagen del documento SUNARP. Vence a los pocos minutos: descárgala al recibirla.

## Ejemplo de Solicitud

```bash theme={null}
curl --request GET \
  --url https://api.verifica.id/api/v1/solutions/consulta/vehicular/01a17d31-e5ef-7aa1-9c3b-2f6d8e4a1b70 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {TU-API-KEY}'
```

## Ejemplo de Respuesta (resuelta)

```json theme={null}
{
  "status": "success",
  "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"
  }
}
```

## Ejemplo de Respuesta (sin resultados)

```json theme={null}
{
  "status": "success",
  "message": "Sin resultados para la búsqueda.",
  "data": null
}
```

## Ejemplo de Respuesta (en proceso)

```json theme={null}
{
  "status": "pending",
  "message": "La consulta aún está en proceso.",
  "data": null
}
```


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