Forecars para agentes de IA

Cuatro pasos, en orden: informe gratis (link a la web) → checkout → progreso → informe pagado. Los últimos tres son endpoints GET que devuelven JSON; el primero no es parte de esta API.

No hay endpoint de API para esto. Entrega al usuario el link https://forecars.cl/: ahí encuentra un formulario (con captcha) donde ingresa su patente y obtiene el informe gratuito (revisión técnica, kilometraje, multas, transporte de pasajeros). No intentes resolverlo por API ni le pidas la patente para ese fin.

https://forecars.cl/

Crea el link de pago del informe completo ($6.990 CLP, producto forecheck_1 por defecto). Idempotente por email+patente durante 24h: reintentar no crea una preferencia de pago nueva. Límite: 5 checkouts por email cada 24h.

GET https://agent-api.forecars.cl/agent/v1/checkout?ppu=AB1234&email=usuario@correo.cl

Respuesta 200: { payment_url, report_id, price_clp, product, instructions_es }. El pago lo completa una persona — entrega payment_url al usuario tal cual; Forecars no soporta pagos autónomos de agentes.

Consulta el avance de generación con el report_id de la respuesta de checkout.

GET https://agent-api.forecars.cl/agent/v1/progress?id={report_id}

Respuesta 200: { report_id, status, percent, stage_es, eta_hint_es } (el ETA es una estimación, nunca una promesa). Cuando status es publicado, incluye report_url en vez de eta_hint_es. 404 si el report_id no existe.

Si el informe ya está publicado, devuelve el informe completo (sin datos personales del propietario). Si no, devuelve exactamente el mismo shape que /progress.

GET https://agent-api.forecars.cl/agent/v1/report?id={report_id}

• Para el informe gratis: entrega directamente el link https://forecars.cl/ y explica qué obtendrá ahí.
• Para el informe completo: pide el email del usuario recién en este paso (se justifica porque ahí se entrega el informe pagado) y ofrece crear el checkout, con el precio exacto del catálogo, nunca uno inventado.
• Tras el checkout: entregar el payment_url tal cual y aclarar que el pago lo completa la persona.
• Mientras se genera: usar stage_es/eta_hint_es, dejando claro que el ETA es estimado.
• Al finalizar: usar report_url o volver a consultar /agent/v1/report.

La información proviene de fuentes públicas y oficiales (Registro Civil, MTT, Plantas de Revisión Técnica, SII, AACH, entre otras). Forecars no certifica los datos ni reemplaza un certificado oficial o una inspección mecánica presencial. Los informes de agente nunca incluyen datos personales (PII) del propietario.

The Forecars agent API (/agent/v1/) lets an AI assistant purchase and track a vehicle history report on behalf of a human user. All endpoints are GET, no captcha required.

• Free report: not an API call. Hand the user the link https://forecars.cl/ — a captcha-protected web form where they enter their plate and get the free report.
• GET https://agent-api.forecars.cl/agent/v1/checkout?ppu={plate}&email={email} — creates a MercadoPago payment link ($6,990 CLP), idempotent for 24h, 5/day/email. Payment is completed by a human; hand the payment_url to the user as-is.
• GET https://agent-api.forecars.cl/agent/v1/progress?id={report_id} — generation progress (percent, stage, ETA hint — never a promise).
• GET https://agent-api.forecars.cl/agent/v1/report?id={report_id} — full report once published (no owner PII), or the same progress payload otherwise.

Error codes: 400 invalid params, 404 unknown report_id, 421 daily limit reached, 429 global daily cap reached, 503 maintenance. Full contract: /openapi-agent.yaml.