Identität und Verifizierung

API zur Validierung spanischer DNI, NIE und NIF

Validieren Sie spanische Ausweis- und Steuernummern in Formularen, beim Onboarding und bei der Rechnungsstellung. Die API erkennt DNIs, NIEs, K-, L- und M-Nummern sowie Unternehmens-NIFs, prüft das Kontrollzeichen und gibt bei Abweichung das erwartete zurück.

Dokumentation anzeigen Kostenloses Tool testen Alle APIs entdecken

Endpunkte Aktiv

GET /v1/national-id/validate

Beispielanfrage

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

Beispielantwort 200 OK

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

Beispielanfrage GET /v1/national-id/validate

Hauptfunktionen 4

Häufig gestellte Fragen 4

HTTP-Statuscodes 200 / 400 / 401 / 402 / 429

Kategorie Identität und Verifizierung

Endpunkte 1

Hauptfunktionen 4

Häufig gestellte Fragen 4

Wird von Mitarbeitenden dieser Unternehmen genutzt

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Live Dienststatus

Prüfen Sie vor der Integration den aktuellen Dienstzustand und die dokumentierten Fehlerantworten.

OpenAPI API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

10,000 Kostenloses Kontingent

Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.

Wobei diese API beim Bauen hilft

Nutze diese Seite als Produktionsbriefing: Endpoints, Beispiele, Antwortstruktur und Workflow-Bausteine, um DomScan in dein Produkt einzubinden.

Produkt-Workflows

Bette Domainchecks, DNS-Intelligence, Risikosignale oder Anreicherung in Onboarding, Suche und interne Tools ein.

Analysten-Automatisierung

Ersetze wiederholte manuelle Lookups durch geplante Jobs, Alerts und reproduzierbare Untersuchungsschritte.

Saubere JSON-Daten

Nutze vorhersehbare Felder, dokumentierte Statuscodes und Credit-Kosten statt Provider-Seiten zu scrapen.

KI- und Ops-Tools

Versorge Agenten, Dashboards, SOAR-Playbooks und CRMs über OpenAPI, SDK, Postman oder MCP.

Integrationsablauf

Ein einfacher Weg von der ersten Anfrage bis zur wiederholbaren Nutzung in Produktion.

Einmal authentifizieren

Sende deinen API-Schlüssel mit dem dokumentierten Header und halte Anfragen über Services hinweg konsistent.

Mit Beispielen abfragen

Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.

Betreiben und überwachen

Nutze Statuscodes, Credit-Kosten und Antwortfelder, um Retries, Logs und Alerts zu bauen.

Developer-Kit

Wechsle von dieser Seite zu maschinenlesbaren Docs, Request-Sammlungen, SDKs oder Agenten-Tools.

OpenAPI-Schema

Generiere Clients oder prüfe jede Request- und Response-Struktur.

Postman-Collection

Importiere fertige Requests für manuelle Tests und Team-Handoff.

SDKs und CLI

Nutze gepflegte Pakete und Kommandozeilen-Workflows statt Boilerplate zu schreiben.

MCP-Integration

Stelle Domain-Intelligence für KI-Agenten und interne Assistenten bereit.

Parameter- und Antwortkarte

Prüfe Eingaben, Ausgabefelder und Statuscodes, bevor du den Endpoint in deinen Client einbindest.

Request-Parameter

Parameter

idcountry

Antwortfelder

Beispielantwort

countrynormalizedvalidtypeentity_typecheckschecks.formatchecks.controlexpected_controlerrors

Statusabdeckung

HTTP-Statuscodes

200400401402429

Endpunkte

GET /v1/national-id/validate

Credits: 1Authentifizierung: Authentifizierung erforderlich

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Live Dienststatus

Prüfen Sie vor der Integration den aktuellen Dienstzustand und die dokumentierten Fehlerantworten.

OpenAPI API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

10,000 Kostenloses Kontingent

Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.

Hauptfunktionen

Jede spanische Nummernart

DNI, NIE, K-, L- und M-NIFs sowie Unternehmens-NIFs (früher CIF), jeweils mit eigenem Format und eigenen Kontrollregeln erkannt.

Erwartetes Kontrollzeichen

Zu einem falschen letzten Zeichen wird das richtige zurückgegeben, sodass Sie Ihren Nutzern die Korrektur vorschlagen können.

Unternehmensform

Unternehmens-NIFs liefern die Art der Einheit und erzwingen, ob diese Form mit einem Buchstaben oder einer Ziffer enden muss.

Nachsichtige Eingabe

Leerzeichen, Punkte, Bindestriche, Kleinbuchstaben, das Präfix ES und 7-stellige DNIs ohne führende Null werden alle akzeptiert.

Beispielanfrage

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"

Beispielantwort

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": []
}

Häufig gestellte Fragen

Bedeutet ein gültiges Ergebnis, dass die Person oder das Unternehmen existiert?

Nein. Die Prüfung belegt, dass die Nummer korrekt aufgebaut ist und ein richtiges Kontrollzeichen hat. Sie belegt nicht, dass die Nummer vergeben wurde oder wem sie gehört.

Kann ich bestätigen, dass ein spanisches Unternehmen umsatzsteuerlich registriert ist?

Ja. Senden Sie die NIF mit dem Präfix ES an die USt-IdNr.-Validierungs-API, die sie live im EU-USt-Register prüft.

Werden Daten gespeichert oder weitergegeben?

Nein. Die Prüfung läuft offline, und die Nummer wird nie an Dritte gesendet.

Wie viele Credits kostet das?

Ein Credit pro Nummer.

HTTP-Statuscodes

Das sind die HTTP-Statuscodes, die Sie behandeln sollten, damit Sie erfolgreiche Antworten, Authentifizierungsprobleme, Credits, Ratenlimits, fehlende Daten und Upstream-Fehler unterscheiden können.

OK 200

Anfrage erfolgreich

Ungültige Anfrage 400

Ungültige Parameter

Nicht autorisiert 401

API-Schlüssel oder Sitzung fehlt oder ist ungültig.

Zahlung erforderlich 402

Nicht genügend Credits für diese Anfrage.

Zu viele Anfragen 429

Ratenlimit überschritten

DNI validieren

Kostenlos starten Dokumentation anzeigen Kostenloses Tool testen

Support

API zur Validierung spanischer DNI, NIE und NIF

Vertrauenssignale vor der Integration

Wobei diese API beim Bauen hilft

Integrationsablauf

Developer-Kit

Parameter- und Antwortkarte

Endpunkte

Vertrauenssignale vor der Integration

Hauptfunktionen

Beispielanfrage

Beispielantwort

Häufig gestellte Fragen

Verwandte Tools und Ressourcen

HTTP-Statuscodes