Consultar respuesta
curl --request GET \
--url https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}', 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://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "<string>",
"message": "<string>",
"data": {
"vin": "<string>",
"placas": [
{
"placa": "<string>",
"estado": "<string>"
}
]
}
}Consulta VIN
Consultar respuesta
Consulta por polling el estado y resultado de una consulta VIN
GET
/
v1
/
consulta
/
vehicular-vin
/
{task_id}
Consultar respuesta
curl --request GET \
--url https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}', 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://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://prd-api.verifica.id/v1/consulta/vehicular-vin/{task_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "<string>",
"message": "<string>",
"data": {
"vin": "<string>",
"placas": [
{
"placa": "<string>",
"estado": "<string>"
}
]
}
}Autenticación
¿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 para conseguirlo.Authorization: Bearer YOUR_API_KEY
Atributos Requeridos
string
required
Identificador de la tarea devuelto por Crear consulta.
Respuesta
Usa el mismo envelope que la entrega por webhook. El campostatus indica el estado de la consulta.
string
Estado de la consulta:
pending (aún en proceso), success (proceso correcto, con o sin resultado) o error (fallo interno).string
Mensaje legible del resultado.
object | null
Carga útil;
null cuando aún está en proceso, no hay coincidencias o hubo error.Show propiedades de data
Show propiedades de data
success = la petición/proceso ocurrió sin error interno, incluso cuando data es null (sin coincidencias). error se reserva para fallos internos: 500 o 503 transitorio (reintentable).Escenarios de Respuesta
Placa encontrada · HTTP 200
{
"status": "success",
"message": "Se ha encontrado la información correctamente.",
"data": {
"vin": "1HGCM82633A004352",
"placas": [
{ "placa": "ABC-123", "estado": "En Circulación" }
]
}
}
En proceso · HTTP 202
{
"status": "pending",
"message": "La consulta aún está en proceso.",
"data": null
}
Sin coincidencias · HTTP 200
Proceso correcto, sin resultado.{
"status": "success",
"message": "No se encontró información para el VIN consultado.",
"data": null
}
Error interno · HTTP 500
{
"status": "error",
"message": "Ocurrió un error al procesar la consulta.",
"data": null
}
Servicio temporalmente no disponible · HTTP 503
Error transitorio: reintenta en unos minutos.{
"status": "error",
"message": "Servicio temporalmente no disponible, reintente en unos minutos.",
"data": null
}
Catálogo de Resultados
| Escenario | HTTP | status | Body |
|---|---|---|---|
| En proceso (solo polling) | 202 | pending | message, data: null |
| Placa encontrada | 200 | success | data: { vin, placas: [ { placa, estado } ] } |
| Sin coincidencias | 200 | success | message, data: null |
| Error interno | 500 | error | message, data: null |
| Servicio no disponible (transitorio) | 503 | error | message, data: null |
Códigos de Error
| Código | Descripción |
|---|---|
| 401 | Token de autenticación inválido o faltante |
| 404 | El task_id no existe |
| 500 | Error interno del servidor |
| 503 | Servicio temporalmente no disponible (transitorio) - reintenta en unos minutos |