Accesso per sviluppatori · Attiva
API per la conversione di estratti conto
Estrai dati di transazione in JSON strutturato da qualsiasi PDF di estratto conto bancario tramite una semplice API REST. Costruita sullo stesso motore di analisi che alimenta PivotBank, oltre 1000 banche, supporto multipagina, integrazione senza configurazione.
Integrazione semplice
Un endpoint. JSON strutturato.
Invia un PDF in POST. Ricevi dati di transazione puliti e strutturati. Ogni risposta include il nome della banca, il periodo dell’estratto conto e un array completo di transazioni con campi normalizzati per data, descrizione, addebito, accredito e saldo.
- ✓Nomi dei campi coerenti per tutte le banche
- ✓Valori null per addebito/accredito mancanti (mai ambigui)
- ✓Output in formato data ISO
- ✓Nome della banca e periodo rilevati automaticamente
- ✓Conteggio pagine incluso per il monitoraggio dell’utilizzo
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
}
]
}Come si chiama
Attiva Pro
L'accesso alle API richiede un abbonamento Pro attivo; l'endpoint rifiuta le chiavi di qualunque altro account.
Crea una chiave API
Generala dalla pagina del tuo account. Viene mostrata una sola volta e ne viene salvato solo l'hash.
Invia il PDF in POST
Manda il PDF a /api/v1/convert con un header Authorization: Bearer, come multipart form-data in un campo "file" o come corpo application/pdf, fino a 15 MB.
Leggi il JSON
Una risposta 200 restituisce bankName, accountNumber, period, pageCount, transactionCount, un oggetto reconciliation e un array transactions con date, description, debit, credit e balance.
Chi usa l’API
Integrazione con software di contabilità
Invia i PDF dei clienti al tuo sistema e ricevi JSON strutturato pronto da registrare direttamente nei libri contabili di Xero, QuickBooks o Sage, senza reinserimento manuale.
Fintech e prestiti
Automatizza l’analisi della sostenibilità per le richieste di prestito. Analizza da 3 a 12 mesi di estratti conto del richiedente in pochi secondi ed estrai redditi, impegni ricorrenti e andamenti del saldo.
Automazione aziendale
Integra l’analisi degli estratti conto nei flussi di lavoro interni, controlli di conformità, gestione delle spese, supporto all’audit o dashboard finanziarie personalizzate.
Modello di prezzo
Pagamento per estratto conto
Accesso
Inclusa con Pro
Banche supportate
Oltre 1000
The API is a Pro feature
Upgrade to Pro to create API keys and convert statements programmatically.
Upgrade to ProLavorare con l'API
Come mi autentico?
Invia la chiave come bearer token: Authorization: Bearer pvb_live_... Le chiavi si creano e si revocano da questa pagina, e l'endpoint richiede un abbonamento Pro attivo, quindi una chiave valida su un account senza Pro viene rifiutata con un 403.
Come invio il PDF?
Come multipart/form-data con il file in un campo chiamato "file", oppure come corpo della richiesta grezzo con Content-Type: application/pdf. Lo stesso endpoint accetta entrambi. Il limite è 15 MB, verificato sulla lunghezza dichiarata prima che il corpo venga letto, così un upload troppo grande viene rifiutato con un 413 invece di essere trasferito.
Cosa torna indietro?
Un oggetto JSON: bankName, accountNumber, period e pageCount rilevati dall'estratto conto, transactionCount e un array transactions. Ogni transazione ha data, descrizione e i campi debit, credit e balance, con null invece di zero dove una colonna manca davvero.
Legge gli estratti conto scansionati?
No, ed è l'unico punto in cui l'API è più limitata dell'app web. Il browser esegue l'OCR su una scansione; l'API analizza solo il livello di testo, e un estratto conto senza testo utilizzabile torna come 422 chiedendo un PDF digitale. Se i tuoi input includono scansioni, convertile nel browser o scrivici.
Cosa significano i codici di errore?
401 per una chiave mancante, non valida o revocata. 403 per una chiave valida su un account senza Pro. 400 per un corpo che non è un PDF leggibile. 413 oltre i 15 MB. 422 per un PDF analizzato che non ha prodotto testo utilizzabile, che in pratica significa una scansione.
Come viene conteggiato l'uso?
Una conversione per chiamata riuscita, registrata sul tuo account con il numero di pagine, esattamente come una conversione nel browser. Una chiamata in errore non viene conteggiata.
Volumi ed enterprise
Converti grandi volumi?
L'API è attiva ed è inclusa nell'abbonamento Pro. Crea una chiave qui sopra e inizia a inviare estratti conto: qui non c'è nessuna lista d'attesa.
Scrivici se converti grandi volumi, ti serve una tariffa su misura o vuoi discutere di un'integrazione prima di costruirla.