API italiana per estratti conto PDF

Endpoint REST sincrono per studi e aziende che vogliono integrare le conversioni nei propri gestionali. Stesse 23 banche del web, stesso pricing a crediti, output JSON + Excel + CSV in un'unica risposta. Incluso nel piano Pro.

Attiva il piano Pro Parla con noi

Come è progettata l'API

Chiavi API cifrate

Le chiavi vengono cifrate al momento della creazione (AES-256). Possono essere rinominate, revocate e limitate a singoli endpoint. La chiave viene mostrata in chiaro una sola volta, alla creazione: nessun recupero successivo.

Limiti per chiave

Ogni chiave ha un proprio rate limit dedicato (100 richieste/minuto per chiave, più un limite per IP). Modificabile su richiesta per piani business. Le chiamate oltre soglia ricevono HTTP 429.

Audit log e crediti

Ogni chiamata viene tracciata senza dati personali nei log (no IBAN, no importi, no descrizioni). I crediti vengono scalati solo al termine della conversione: se l'API risponde 5xx, nessun addebito.

Endpoint principali

Un solo endpoint sincrono: invii il PDF, ricevi i dati. Autenticazione con chiave Pro via header Bearer.

POST/api/v1/conversions: Endpoint SINCRONO: invii il PDF (raw application/pdf o multipart con campo file) con header Authorization: Bearer eccx_... e ricevi nella stessa risposta il risultato completo — bankDetected, pageCount, creditsConsumed, confidenceScore e l'array rows dei movimenti, più csv e xlsxBase64 pronti da salvare. Nessun polling, nessun job_id.

Domande frequenti sull'API

L'API è già disponibile?

Sì. L'endpoint POST /api/v1/conversions è live e sincrono. Per ottenere una chiave serve il piano Pro: la generi dalla tua area riservata (sezione API keys), la vedi in chiaro una sola volta e la usi come Authorization: Bearer. Le chiavi hanno scope (es. conversions:write) e possono essere revocate in qualsiasi momento.

Quanto costa una chiamata API?

Stesso pricing del web: 1 credito per scansione (documento intero), indipendentemente dal numero di pagine e senza sovrapprezzo per l'OCR. Se la conversione non è utilizzabile (0 righe) il credito viene rimborsato automaticamente.

Quali formati restituisce l'API?

Un'unica risposta JSON che contiene sia i dati strutturati (array rows con data operazione, data valuta, descrizione, entrate, uscite, saldo e uno score di confidenza per riga) sia il file già pronto: csv (UTF-8, separatore punto e virgola, virgola decimale) e xlsxBase64. Non serve una seconda chiamata per scaricare l'output.

Dove vengono elaborati i dati?

Il database dei metadati è in Unione Europea (region eu-central-1). Il PDF inviato via API non viene mai salvato: è elaborato in memoria durante la richiesta e scartato al termine, esattamente come dal web. DPA disponibile per studi e aziende clienti API.

L'API supporta tutte le 23 banche del web?

Sì. L'API condivide gli stessi parser dedicati (Intesa Sanpaolo, UniCredit, BancoPosta, Fineco, BPER, BNL, MPS, Banco BPM, Mediolanum, Credit Agricole, Credem, ING, Sella, Revolut, N26, Wise, Hype, Satispay, Trade Republic, Vivid Money, buddybank e altre) e la stessa strategia generica per banche non ancora coperte.

Posso integrare l'API in TeamSystem, Zucchetti o altri gestionali?

Sì. L'export JSON è pensato proprio per integrazioni gestionali: ogni riga porta data contabile, data valuta, descrizione, entrate, uscite, saldo e una colonna confidence (0-1) per filtrare le righe da revisionare manualmente prima dell'import.

Risorse correlate

Esplora il servizio.

Banche supportate

23 parser dedicati per PDF bancari italiani e fintech.

Per commercialisti

Multi-cliente, batch, audit log e template contabili.

Sicurezza e privacy

PDF elaborato in memoria e mai salvato. Server EU, GDPR-first.

Guide pratiche

Come scaricare il PDF da Intesa, Fineco, Revolut e altre.

Prezzi e crediti

Gratis per iniziare. Piani a consumo senza abbonamento.

Caricamento…