Acceso para desarrolladores · En funcionamiento
API conversora de extractos bancarios
Extrae datos de transacciones en JSON estructurado desde cualquier PDF de extracto bancario mediante una sencilla API REST. Construida sobre el mismo motor de análisis que impulsa PivotBank: más de 1000 bancos, soporte multipágina e integración sin configuración.
Integración sencilla
Un solo endpoint. JSON estructurado.
Envía un PDF por POST. Recibe datos de transacciones limpios y estructurados. Cada respuesta incluye el nombre del banco, el período del extracto y un array completo de transacciones con campos normalizados de fecha, descripción, débito, crédito y saldo.
- ✓Nombres de campo consistentes en todos los bancos
- ✓Valores nulos para débito/crédito ausentes (nunca ambiguos)
- ✓Salida con formato de fecha ISO
- ✓Nombre del banco y período detectados automáticamente
- ✓Recuento de páginas incluido para el seguimiento de uso
POST /api/v1/convert
Authorization: Bearer {API_KEY}
Content-Type: multipart/form-data
# Response: 200 OK
{
"bankName": "HSBC",
"accountNumber": "1234 5678",
"period": "Jan 2025, Mar 2025",
"pageCount": 3,
"transactionCount": 2,
"reconciliation": {
"verified": true,
"status": "ok",
"opening": 2384.21,
"closing": 6841.22,
"expectedClosing": 6841.22,
"difference": 0,
"totalIn": 4500.00,
"totalOut": 42.99
},
"transactions": [
{
"date": "2025-01-03",
"description": "AMAZON.CO.UK",
"debit": 42.99,
"credit": null,
"balance": 2341.22
},
{
"date": "2025-01-07",
"description": "SALARY - ACME LTD",
"debit": null,
"credit": 4500.00,
"balance": 6841.22
}
]
}Cómo llamarla
Suscríbete a Pro
El acceso a la API requiere una suscripción Pro activa; el endpoint rechaza las claves de cualquier otra cuenta.
Crea una clave de API
Genérala desde la página de tu cuenta. Se muestra una sola vez y solo se guarda su hash.
Envía el PDF por POST
Manda el PDF a /api/v1/convert con una cabecera Authorization: Bearer, como multipart form-data en un campo "file" o como cuerpo application/pdf, hasta 15 MB.
Lee el JSON
Una respuesta 200 devuelve bankName, accountNumber, period, pageCount, transactionCount, un objeto reconciliation y un array transactions con date, description, debit, credit y balance.
Quién usa la API
Integración con software de contabilidad
Envía los PDF de tus clientes a tu propio sistema y recibe JSON estructurado listo para registrar directamente en los libros de Xero, QuickBooks o Sage, sin reescritura manual.
Fintech y préstamos
Automatiza el análisis de solvencia para solicitudes de préstamo. Analiza de 3 a 12 meses de extractos del solicitante en segundos y extrae ingresos, compromisos recurrentes y tendencias de saldo.
Automatización empresarial
Integra el análisis de extractos bancarios en flujos de trabajo internos: controles de cumplimiento, procesamiento de gastos, soporte de auditoría o paneles financieros personalizados.
Modelo de precios
Pago por extracto
Acceso
Incluido con Pro
Bancos compatibles
Más de 1000
The API is a Pro feature
Upgrade to Pro to create API keys and convert statements programmatically.
Upgrade to ProTrabajar con la API
¿Cómo me autentico?
Envía tu clave como token bearer: Authorization: Bearer pvb_live_... Las claves se crean y revocan en esta página, y el endpoint requiere una suscripción Pro activa, así que una clave válida en una cuenta sin Pro se rechaza con un 403.
¿Cómo envío el PDF?
Como multipart/form-data con el archivo en un campo llamado "file", o como cuerpo de petición en crudo con Content-Type: application/pdf. El mismo endpoint acepta ambos. El límite es de 15 MB, comprobado contra la longitud declarada antes de leer el cuerpo, así que una subida demasiado grande se rechaza con un 413 en lugar de transferirse.
¿Qué devuelve?
Un objeto JSON: bankName, accountNumber, period y pageCount detectados del extracto, transactionCount y un array transactions. Cada transacción tiene fecha, descripción y campos debit, credit y balance, con null en lugar de cero cuando una columna realmente no existe.
¿Lee extractos escaneados?
No, y es el único punto en el que la API es más limitada que la aplicación web. El navegador ejecuta OCR sobre un escaneo; la API solo analiza la capa de texto, y un extracto sin texto utilizable devuelve un 422 pidiendo un PDF digital. Si tus entradas incluyen escaneos, conviértelos en el navegador o consúltanos.
¿Qué significan los códigos de error?
401 si falta la clave o es inválida o revocada. 403 para una clave válida en una cuenta sin Pro. 400 para un cuerpo que no es un PDF legible. 413 por encima de 15 MB. 422 para un PDF que se analizó pero no dio texto utilizable, lo que en la práctica significa un escaneo.
¿Cómo se cuenta el uso?
Una conversión por llamada correcta, registrada en tu cuenta con el número de páginas, igual que una conversión en el navegador. Una llamada con error no cuenta.
Volumen y empresas
¿Conviertes a gran volumen?
La API está en funcionamiento y se incluye con la suscripción Pro. Crea una clave arriba y empieza a enviar extractos; aquí no hay ninguna lista de espera.
Escríbenos si conviertes a gran volumen, necesitas una tarifa a medida o quieres comentar una integración antes de construirla.