Identità e verifica

API di convalida di IBAN e coordinate bancarie

Individua gli errori nei dati di pagamento prima che un bonifico fallisca. Invia un IBAN, un BIC e un numero di routing USA in qualsiasi combinazione e ottieni il problema esatto, il codice banca e il numero di conto, l’appartenenza alla SEPA e se il BIC corrisponde al Paese dell’IBAN.

Consulta la documentazione Prova lo strumento gratuito Esplora tutte le API

Endpoint Attivo

POST /v1/bank/validate

Richiesta di esempio

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"iban": "DE89 3704 0044 0532 0130 00", "bic": "COBADEFFXXX"}' \
  "https://domscan.net/v1/bank/validate"

Risposta di esempio 200 OK

{
  "valid": true,
  "iban": {
    "valid": true,
    "iban": "DE89370400440532013000",
    "iban_print": "DE89 3704 0044 0532 0130 00",
    "country_code": "DE",
    "bank_code": "37040044",
    "account_number": "0532013000",
    "sepa": true,
    "checks": { "length": "pass", "structure": "pass", "checksum": "pass" }
  },
  "bic": { "valid": true, "bic":
...

Richiesta di esempio POST /v1/bank/validate

Caratteristiche Principali 4

Domande frequenti 4

Codici di stato HTTP 200 / 400 / 401 / 402 / 409 / 422 / 429

Categoria Identità e verifica

Endpoint 1

Caratteristiche Principali 4

Domande frequenti 4

Usato da persone di queste aziende

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

10,000 Quota gratuita

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Cosa ti aiuta a costruire questa API

Usa questa pagina come brief di produzione: endpoint, esempi, forma della risposta e parti del workflow per integrare DomScan nel tuo prodotto.

Workflow di prodotto

Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.

Automazione per analisti

Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.

Dati JSON puliti

Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.

AI e strumenti ops

Alimenta agenti, dashboard, playbook SOAR e CRM tramite OpenAPI, SDK, Postman o MCP.

Workflow di integrazione

Un percorso semplice dalla prima richiesta all’uso ripetibile in produzione.

Autentica una volta

Invia la tua chiave API con l’header documentato e mantieni richieste coerenti tra servizi.

Interroga con esempi

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

Opera e monitora

Usa codici di stato, costi in crediti e campi di risposta per costruire retry, log e alert.

Kit sviluppatori

Passa da questa pagina a docs leggibili da macchina, raccolte di richieste, SDK o strumenti per agenti.

Schema OpenAPI

Genera client o ispeziona ogni forma di richiesta e risposta.

Collezione Postman

Importa richieste pronte per test manuali e handoff al team.

SDK e CLI

Usa pacchetti mantenuti e workflow da riga di comando invece di scrivere boilerplate.

Integrazione MCP

Esponi intelligence sui domini ad agenti AI e assistenti interni.

Mappa di parametri e risposta

Controlla input, campi di output e codici di stato prima di collegare l’endpoint al tuo client.

Parametri richiesta

Parametro

ibanbicrouting_number

Campi risposta

Risposta di esempio

validibaniban.validiban.ibaniban.iban_printiban.country_codeiban.bank_codeiban.account_numberiban.sepaiban.checksiban.checks.lengthiban.checks.structure

Copertura stati

Codici di stato HTTP

200400401402409422429

Endpoint

POST /v1/bank/validate

Crediti: 1Autenticazione: Autenticazione richiesta

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

10,000 Quota gratuita

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Caratteristiche Principali

Tutti i Paesi IBAN

Paese, lunghezza, formato nazionale del conto e cifre di controllo ISO 7064 per ogni Paese del registro IBAN, più i territori che usano il formato di un Paese di riferimento.

Codice banca e numero di conto

Un IBAN valido viene suddiviso in codice banca, codice filiale e numero di conto, sia nel formato elettronico sia in quello di stampa.

BIC e numeri di routing

Struttura e Paese del BIC/SWIFT, codici di prova e numeri di routing USA ABA con la relativa cifra di controllo e il distretto della Federal Reserve.

Privato per progettazione

La convalida avviene offline. I numeri di conto non vengono mai inviati a terzi e non vengono conservati nei log delle richieste.

Richiesta di esempio

POST /v1/bank/validate bash

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"iban": "DE89 3704 0044 0532 0130 00", "bic": "COBADEFFXXX"}' \
  "https://domscan.net/v1/bank/validate"

Risposta di esempio

200 OK json

{
  "valid": true,
  "iban": {
    "valid": true,
    "iban": "DE89370400440532013000",
    "iban_print": "DE89 3704 0044 0532 0130 00",
    "country_code": "DE",
    "bank_code": "37040044",
    "account_number": "0532013000",
    "sepa": true,
    "checks": { "length": "pass", "structure": "pass", "checksum": "pass" }
  },
  "bic": { "valid": true, "bic": "COBADEFFXXX", "institution_code": "COBA", "country_code": "DE" },
  "bic_iban_country_relation": "same",
  "signals": []
}

Domande frequenti

Un IBAN valido dimostra che il conto esiste?

No. Dimostra che l’IBAN è formato correttamente, il che intercetta quasi ogni errore di digitazione. Solo la banca del titolare può confermare che il conto è aperto e a chi appartiene.

Cosa succede quando il BIC appartiene a un altro Paese?

Il risultato riporta un segnale, mai un errore, perché alcuni pagamenti usano legittimamente un BIC di un altro Paese. Territori come Guernsey, Jersey o i dipartimenti francesi d’oltremare vengono riconosciuti.

Restituite il nome della banca?

No. Non esiste un elenco gratuito, completo e ufficiale dei nomi delle banche, quindi l’API restituisce invece i codici banca e filiale contenuti nell’IBAN.

Quanti crediti costa?

Un credito per richiesta, che tu invii un IBAN, un BIC, un numero di routing o tutti e tre.

Strumenti e risorse correlati

Codici di stato HTTP

Questi sono i codici di stato HTTP da gestire, per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di frequenza, dati mancanti ed errori a monte.

OK 200

Richiesta riuscita

Richiesta non valida 400

Parametri non validi

Non autorizzato 401

Chiave API o sessione mancante o non valida.

Pagamento richiesto 402

Crediti insufficienti per eseguire questa richiesta.

HTTP 409 409

Questi sono i codici di stato HTTP da gestire, per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di frequenza, dati mancanti ed errori a monte.

HTTP 422 422

Questi sono i codici di stato HTTP da gestire, per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di frequenza, dati mancanti ed errori a monte.

Troppe richieste 429

Limite di richieste superato

Convalida le coordinate bancarie

Inizia gratis Consulta la documentazione Prova lo strumento gratuito