Identità e verifica

API di convalida di DNI, NIE e NIF spagnoli

Convalida i numeri di identità e fiscali spagnoli in moduli, onboarding e fatturazione. L’API riconosce DNI, NIE, numeri K, L e M e NIF aziendali, verifica il carattere di controllo e restituisce quello atteso quando non corrisponde.

Consulta la documentazione Prova lo strumento gratuito Esplora tutte le API

Endpoint Attivo

GET /v1/national-id/validate

Richiesta di esempio

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/national-id/validate?id=B58378431"

Risposta di esempio 200 OK

{
  "country": "ES",
  "normalized": "B58378431",
  "valid": true,
  "type": "cif",
  "entity_type": "sociedad_responsabilidad_limitada",
  "checks": { "format": true, "control": true },
  "expected_control": null,
  "errors": []
}

Richiesta di esempio GET /v1/national-id/validate

Caratteristiche Principali 4

Domande frequenti 4

Codici di stato HTTP 200 / 400 / 401 / 402 / 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

idcountry

Campi risposta

Risposta di esempio

countrynormalizedvalidtypeentity_typecheckschecks.formatchecks.controlexpected_controlerrors

Copertura stati

Codici di stato HTTP

200400401402429

Endpoint

GET /v1/national-id/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

Ogni tipo di numero spagnolo

DNI, NIE, NIF K, L e M e NIF aziendali (in precedenza CIF), ciascuno riconosciuto con il proprio formato e le proprie regole di controllo.

Carattere di controllo atteso

Un ultimo carattere errato viene restituito insieme a quello corretto, così puoi suggerire la correzione al tuo utente.

Tipo di società

I NIF aziendali restituiscono il tipo di entità e verificano se quel tipo deve terminare con una lettera o con una cifra.

Input tollerante

Spazi, punti, trattini, lettere minuscole, il prefisso ES e i DNI di 7 cifre senza lo zero iniziale sono tutti accettati.

Richiesta di esempio

GET /v1/national-id/validate?id=B58378431 bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/national-id/validate?id=B58378431"

Risposta di esempio

200 OK json

{
  "country": "ES",
  "normalized": "B58378431",
  "valid": true,
  "type": "cif",
  "entity_type": "sociedad_responsabilidad_limitada",
  "checks": { "format": true, "control": true },
  "expected_control": null,
  "errors": []
}

Domande frequenti

Un risultato valido significa che la persona o l’azienda esiste?

No. La verifica dimostra che il numero è formato correttamente con un carattere di controllo corretto. Non dimostra che il numero sia stato rilasciato né chi ne sia il titolare.

Posso confermare che un’azienda spagnola è registrata ai fini IVA?

Sì. Invia il NIF con il prefisso ES all’API di convalida partita IVA, che lo verifica in tempo reale con il registro IVA dell’UE.

Vengono conservati o condivisi dei dati?

No. La verifica avviene offline e il numero non viene mai inviato a terzi.

Quanti crediti costa?

Un credito per numero.

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.

Troppe richieste 429

Limite di richieste superato

Convalida un DNI

Inizia gratis Consulta la documentazione Prova lo strumento gratuito