Documentación

Autenticación

Creá una API key en el panel y mandala en cada llamada:

Authorization: Bearer bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

POST /v1/parse

multipart/form-data con:

file (obligatorio): PDF, CSV, XLS o XLSX, hasta 10 MB.
bank (opcional): auto (por defecto), brou, itau, santander, scotiabank, prex.

Respuesta 200

{
  "status": "success",
  "bank_detected": "itau",
  "parser": "tabla_generica",
  "currency": "UYU",
  "account_number_masked": "****1234",
  "period": { "from": "2026-10-01", "to": "2026-10-31" },
  "opening_balance": 45200.50,
  "closing_balance": 38910.00,
  "transactions": [
    {
      "date": "2026-10-03",
      "description": "TRANSFERENCIA INSTANTANEA",
      "reference": "982374",
      "debit": 6290.50,
      "credit": 0.00,
      "balance": 38910.00
    }
  ]
}

Los movimientos vienen en orden cronológico. balance, reference, currency y account_number_masked pueden ser null si el extracto no los trae. Cada respuesta incluye los headers X-Quota-Limit y X-Quota-Remaining.

Errores

Siempre {"status": "error", "code": "…", "message": "…"}. Las llamadas con error no consumen cuota.

HTTP	code	Cuándo
401	api_key_invalida	Falta la key o fue revocada.
429	cuota_agotada	Se usaron todas las llamadas del mes.
422	parametros_invalidos	Falta el archivo, es muy grande o el banco no existe.
415	formato_no_soportado	Extensión distinta de PDF, CSV, XLS o XLSX.
422	formato_no_reconocido	La planilla no tiene encabezados reconocibles.
422	banco_no_soportado	PDF de un banco que todavía no soportamos.
422	pdf_sin_texto	PDF escaneado (imagen), sin texto.
422	pdf_invalido · archivo_invalido	Archivo dañado o protegido.
422	sin_movimientos	Formato reconocido pero sin movimientos.

Formatos soportados

CSV / XLS / XLSX de cualquier banco con encabezados del tipo Fecha, Descripción/Concepto, Débito/Crédito o Importe y Saldo: disponible.
PDF de BROU, Itaú, Santander, Scotiabank y Prex: en desarrollo. Si querés que priorizemos tu banco, escribinos.