Identità e verifica

API di controllo delle sanzioni

Controlla clienti, fornitori e controparti all’onboarding e prima dei pagamenti. Una sola richiesta cerca in cinque liste ufficiali delle sanzioni e restituisce ogni possibile corrispondenza con la voce della lista, i programmi, i Paesi, le date di nascita e un punteggio di corrispondenza.

Consulta la documentazione Prova lo strumento gratuito Esplora tutte le API

Endpoint Attivo

POST /v1/sanctions/screen

Richiesta di esempio

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Banco Nacional de Cuba"}' \
  "https://domscan.net/v1/sanctions/screen"

Risposta di esempio 200 OK

{
  "status": "potential_match",
  "matches": [
    {
      "list": "ofac_sdn",
      "entry_id": "306",
      "name_score": 1,
      "match_type": "exact",
      "matched_name": "BANCO NACIONAL DE CUBA",
      "entity_type": "organization",
      "programs": ["CUBA"],
      "aliases": ["BNC", "NATIONAL BANK OF CUBA"],
      "signals": { "date_of_birth": "no
...

Richiesta di esempio POST /v1/sanctions/screen

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

nametypecountrydate_of_birthliststhresholdlimit

Campi risposta

Risposta di esempio

statusmatchestotal_matcheslists

Copertura stati

Codici di stato HTTP

200400401402409422429

Endpoint

POST /v1/sanctions/screen

Crediti: 2Autenticazione: 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

Cinque liste ufficiali, aggiornate ogni giorno

Liste OFAC SDN e consolidata (non SDN) degli USA, Consiglio di sicurezza dell’ONU, sanzioni finanziarie dell’UE e sanzioni del Regno Unito, con la data di pubblicazione di ogni lista in ogni risultato.

Corrispondenza approssimata pensata per i nomi

Ordine delle parole, accenti, traslitterazione, alias, iniziali, errori di battitura e grafie foneticamente simili, oltre ai nomi originali in alfabeto cirillico e arabo.

Segnali che non nascondono mai una corrispondenza

Data di nascita e Paese ordinano le corrispondenze e vengono riportati come coincidenza o discordanza, ma la soglia si applica al solo nome.

Nessun falso via libera

no_match viene restituito solo quando ogni lista è stata confermata nelle ultime 72 ore. In caso contrario il risultato è sconosciuto e non viene addebitato.

Richiesta di esempio

POST /v1/sanctions/screen bash

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Banco Nacional de Cuba"}' \
  "https://domscan.net/v1/sanctions/screen"

Risposta di esempio

200 OK json

{
  "status": "potential_match",
  "matches": [
    {
      "list": "ofac_sdn",
      "entry_id": "306",
      "name_score": 1,
      "match_type": "exact",
      "matched_name": "BANCO NACIONAL DE CUBA",
      "entity_type": "organization",
      "programs": ["CUBA"],
      "aliases": ["BNC", "NATIONAL BANK OF CUBA"],
      "signals": { "date_of_birth": "not_provided", "country": "not_provided" }
    }
  ],
  "total_matches": 1,
  "lists": [
    { "id": "ofac_sdn", "status": "checked", "entries": 19457, "published_at": "2026-10-16" },
    { "id": "un", "status": "checked", "entries": 1010 },
    { "id": "eu", "status": "checked", "entries": 6234 },
    { "id": "uk", "status": "checked", "entries": 6408 }
  ]
}

Domande frequenti

Una possibile corrispondenza è una decisione?

No. È uno spunto che richiede l’esame di una persona rispetto alla voce della lista. DomScan non stabilisce se una persona o un’azienda sia il soggetto sanzionato.

Copre le persone politicamente esposte (PEP)?

No. L’API controlla solo le liste ufficiali delle sanzioni. Non include PEP, notizie negative o liste di controllo di altre fonti.

I nomi controllati vengono conservati?

Le richieste di controllo non vengono conservate nei tuoi log delle richieste. Vengono conservati solo i registri di utilizzo e fatturazione.

Quanti crediti costa?

Due crediti per nome. I risultati sconosciuti perché una lista non è aggiornata o non è disponibile non vengono addebitati.

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

Controlla un nome

Inizia gratis Consulta la documentazione Prova lo strumento gratuito