Informes de historial del vehículo
Carfax y AutoCheck por VIN, cuando los necesites.
Comprueba gratis cuántos registros tiene cada proveedor para un VIN y pide el informe completo solo cuando valga la pena. Recibes un enlace al informe HTML, un PDF opcional y tu saldo tras el cobro.
GET /reports/{type}/{vin}- html
- base64
- balance_after
Cómo funciona
- 1
Comprueba los registros (gratis)
Llama a
/reports/check-records/{vin}.Devuelve cuántos registros de Carfax y AutoCheck existen y el nombre del vehículo. No se cobra nada. - 2
Pide el informe (de pago)
Llama a
/reports/{type}/{vin}con type carfax o autocheck. El precio de un informe se descuenta de tu saldo en USD. - 3
Usa el resultado
Abre el enlace html, añade pdf=1 cuando necesites un archivo PDF y lee
balance_afterpara saber cuánto te queda.
Comprueba un VIN ahora
Gratis: solo cuenta los registros.
GET /reports/check-records/{vin}VIN de prueba gratis
Usa este VIN para probar los dos pasos. Sus informes son gratis.
Facturación
- Los informes se pagan de un único saldo en USD, compartido con Pay per VIN.
/reports/balancelo muestra. - check-records, balance y my-history son gratis.
- Con days=N, un informe que ya generaste en los últimos N días se devuelve de nuevo en lugar de crear uno nuevo.
- Si el saldo es insuficiente, la API responde 402 con insufficient funds y no cobra nada.
- Si un proveedor no tiene historial para el VIN, la API responde 400 con records not found for this vin number y no cobra nada.
Referencia de la API
Conviene saber
- El VIN debe tener exactamente 17 caracteres; cualquier otro valor devuelve 400.
- pdf=1 puede tardar de 40 a 60 segundos. Usa un timeout largo y nunca envíes la misma solicitud dos veces: un duplicado recibe 409 generation already in progress, con Retry-After.
- base64 contiene el cuerpo cifrado del informe. Añade
exclude_base_64=1cuando solo necesites los enlaces. - Los valores html y pdf son enlaces a archivos. Guarda el enlace o el archivo en tu lado.