Consulta Vehicular
curl --request POST \
--url https://api.verifica.id/v2/consulta/vehicular \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"plate": "<string>"
}
'import requests
url = "https://api.verifica.id/v2/consulta/vehicular"
payload = { "plate": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({plate: '<string>'})
};
fetch('https://api.verifica.id/v2/consulta/vehicular', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.verifica.id/v2/consulta/vehicular",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'plate' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.verifica.id/v2/consulta/vehicular"
payload := strings.NewReader("{\n \"plate\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.verifica.id/v2/consulta/vehicular")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"plate\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.verifica.id/v2/consulta/vehicular")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"plate\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"type": "<string>",
"status": 123,
"message": "<string>",
"data": {
"license_plate_number": "<string>",
"serial_number": "<string>",
"vin_number": "<string>",
"engine_number": "<string>",
"color": "<string>",
"make": "<string>",
"model": "<string>",
"current_license_plate": "<string>",
"previous_license_plate": "<string>",
"status": "<string>",
"annotations": "<string>",
"registration_office": "<string>",
"model_year": "<string>",
"owners": [
{}
],
"file_url": "<string>"
}
}Consulta Vehicular
Consulta Vehicular
Consulta la información de un vehículo a partir de su número de placa
POST
/
v2
/
consulta
/
vehicular
Consulta Vehicular
curl --request POST \
--url https://api.verifica.id/v2/consulta/vehicular \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"plate": "<string>"
}
'import requests
url = "https://api.verifica.id/v2/consulta/vehicular"
payload = { "plate": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({plate: '<string>'})
};
fetch('https://api.verifica.id/v2/consulta/vehicular', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.verifica.id/v2/consulta/vehicular",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'plate' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.verifica.id/v2/consulta/vehicular"
payload := strings.NewReader("{\n \"plate\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.verifica.id/v2/consulta/vehicular")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"plate\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.verifica.id/v2/consulta/vehicular")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"plate\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"type": "<string>",
"status": 123,
"message": "<string>",
"data": {
"license_plate_number": "<string>",
"serial_number": "<string>",
"vin_number": "<string>",
"engine_number": "<string>",
"color": "<string>",
"make": "<string>",
"model": "<string>",
"current_license_plate": "<string>",
"previous_license_plate": "<string>",
"status": "<string>",
"annotations": "<string>",
"registration_office": "<string>",
"model_year": "<string>",
"owners": [
{}
],
"file_url": "<string>"
}
}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):Authorization: Bearer YOUR_API_KEY
Atributos Requeridos
Número de placa del vehículo a consultar
Respuesta
Tipo de respuesta (ej: “result”)
Código de estado HTTP de la respuesta (ej: 200)
Mensaje descriptivo del resultado de la validación
Datos del vehículo consultado
Show propiedades de data
Show propiedades de data
Número de placa del vehículo
Número de serie del vehículo
Número de identificación del vehículo (VIN)
Número de motor
Color del vehículo
Marca del vehículo
Modelo del vehículo
Placa actual del vehículo
Placa anterior del vehículo (ej: “NINGUNA”)
Estado del vehículo (ej: “EN CIRCULACION”)
Anotaciones registradas (ej: “NINGUNA”)
Oficina registral
Año del modelo
Lista de propietarios del vehículo
URL firmada para descargar el documento del vehículo
Ejemplo de Solicitud
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
{
"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 |
⌘I