Telefonnummern validieren und normalisieren

Q: Was prüft die Omikron Telefonvalidierungs-API genau?

Die API prüft, ob eine Rufnummer syntaktisch korrekt ist, ob die Ländervorwahl zur angegebenen Adresse passt, ob es sich um Festnetz oder Mobilfunk handelt, und gibt die Nummer im gewünschten Format zurück – E.164, Darstellungsformat oder beides parallel.

Q: Was ist E.164 und warum brauche ich das?

E.164 ist der internationale ITU-Standard: Länderkennzeichen + Vorwahl + Teilnehmernummer, ohne Trennzeichen. Nummern in diesem Format werden von browserbasierten Systemen, SMS-Gateways und CTI-Plattformen als klickbarer Hyperlink erkannt – und sind sofort automatisch nutzbar.

Q: Was passiert, wenn Rufnummer und Adresse unterschiedliche Länder haben?

Die API erkennt die Abweichung und gibt einen klaren Fehlerhinweis zurück, z. B. "Found wrong country code for country ". Sie entscheiden, ob ein Hinweis im Formular erscheint oder der Datensatz im CRM markiert wird oder nichts passiert.

Q: Werden Tippfehler in der Teilnehmernummer erkannt?

Nicht existierende Vorwahlen und falsche Ländercodes werden zuverlässig erkannt. Zahlendreher innerhalb der Teilnehmernummer können nicht geprüft werden, da keine Leitungsverbindung aufgebaut wird – dafür gibt es den optionalen HLR-Lookup.

Q: Was ist der HLR-Lookup und wann ist er sinnvoll?

HLR-Lookup ist ein optionales Add-on: Es fragt netzseitig ab, ob eine SIM-Karte aktiv ist und zu welchem Carrier die Nummer gehört. Sinnvoll vor Massenkampagnen per SMS oder WhatsApp, um Versandkosten für inaktive Nummern zu vermeiden.

Q: Unterstützt die API internationale Rufnummern?

Ja. Die API arbeitet mit Vorwahllisten für über 100 Länder auf Basis offizieller ITU-Daten. Darstellungsformate und Validierungsregeln sind länderspezifisch konfigurierbar – für Deutschland, Österreich, Schweiz und internationale Märkte gleichermaßen.

Saubere Rufnummern für CRM, Messaging und Automatisierung.

Sehen Sie in 90 Sekunden, wie Omikrons API fehlerhafte Rufnummern erkennt, das Format bereinigt und einen konkreten Fehlerfall in Echtzeit aufdeckt – inklusive Live-Demo mit Adress-Plausibilitätsprüfung.

Erstgespräch starten

Was die Omikron Telefonvalidierungs-API leistet

Syntaxprüfung

Formatfehler, falsche Sonderzeichen und fehlende Trennzeichen werden automatisch erkannt und bereinigt.

Ländervorwahl-Erkennung

Passt die Vorwahl zum angegebenen Land? Stimmt das Länderkennzeichen (z. B. +49 für DE)?

E.164 Normalisierung

Jede Nummer wird in den internationalen ITU-Standard gebracht – weltweit eindeutig und sofort maschinenlesbar.

Festnetz / Mobilfunk

Die API erkennt automatisch, ob es sich um eine Festnetz- oder Mobilfunknummer handelt.

Region-Lookup

Ort und Region werden aus der Vorwahl abgeleitet – z. B. +49 89 63632100 → Ismaning.

Adress-Plausibilität

Stimmt die Telefonnummer mit dem angegebenen Land der Adresse überein? Mismatch wird sofort gemeldet.

Darstellungsformat

Länderspezifisch konfigurierbar: mit Leerzeichen, Bindestrich oder abgesetzter Durchwahl.

HRL-Loopup
(Add-on)

SIM-Aktivstatus und Carrier-Info direkt vom Mobilfunknetz – ideal vor Massenversand per SMS.

Syntaxprüfung und Formatbereinigung

Egal wie eine Telefonnummer eingegeben wurde – mit Leerzeichen, ohne Ländervorwahl oder mit falschen Sonderzeichen – Omikron räumt automatisch auf. Das Ergebnis ist eine saubere, einheitliche Nummer, die Ihre Systeme problemlos weiterverarbeiten können.

Jetzt Demo API Key anfordern

Syntaxprüfung und Formatbereinigung

Normalisierung der Telefonnummer nach internationalem Standard E.164

Normalisierung nach E.164

E.164 ist der internationale Standard für Telefonnummern. Aus der deutschen nummer "07231 / 60 740 74 - 0" wird "+49723160740740". Das ist weltweit eindeutig. Omikron bringt jede Nummer automatisch in dieses Format. Damit können alle Ihre Systeme – CRM, SMS-Versand, Telefonie – die Nummer sofort verstehen und nutzen.

Jetzt Demo API Key anfordern

Normalisierung nach E.164

Adress-Plausibilitätsprüfung

Hat jemand versehentlich – oder absichtlich – eine Telefonnummer aus dem falschen Land eingetragen? Omikron erkennt das sofort: Wenn Telefonnummer und Adresse nicht zusammenpassen, erscheint ein klarer Warnhinweis. So landen keine Fehler unbemerkt in Ihrem System.

Jetzt Demo API Key anfordern

Plausibilitätsprüfung Telefonnummer zu Adresse

Adress-Plausibilitätsprüfung

Festnetz, Mobilfunk und Region erkennen

Ist es eine Handy- oder Festnetznummer? Und aus welcher Region kommt sie? Omikron beantwortet das automatisch. So wissen Sie zum Beispiel schon bei der Registrierung, ob ein Kontakt per SMS oder Festnetz erreichbar ist – ohne manuell nachschauen zu müssen.

Jetzt Demo API Key anfordern

Festnetz, Mobilfunk und Region erkennen

Benutzerdefiniertes Darstellungsformat

Wie soll die Telefonnummer auf dem Bildschirm Ihrer Nutzer erscheinen? Mit Leerzeichen, Bindestrich oder abgesetzter Durchwahl? Omikron liefert die Nummer exakt in dem Format, das Sie festlegen – und passt das für jedes Land automatisch richtig an.

Jetzt Demo API Key anfordern

Telefonnummern vereinheitlichen mit benutzerdefinierter Darstellung

Benutzerdefiniertes Darstellungsformat

Mit HRL-Lookup Status und Anbieter der Telefonnummer prüfen

Optionaler HLR-Lookup

Als optionale Erweiterung prüft Omikron direkt beim Mobilfunknetz, ob eine Handynummer aktiv ist und welchem Anbieter sie gehört. So versenden Sie keine SMS an gesperrte oder nicht existierende Nummern – und sparen damit bares Geld.

Jetzt Demo API Key anfordern

Optionaler HLR-Lookup

Was saubere Rufnummern für Ihr Unternehmen bedeuten

Höhere Erreichbarkeit

Mehr Kampagnen landen beim richtigen Kontakt – kein Rausschuss mehr.

Weniger Kampagnenkosten

Keine SMS-Gebühren für ungültige oder falsche Nummern.

CRM-Qualität

Saubere Eingangsqualität und bereinigter Bestand auf Knopfdruck.

Automation-ready

E.164-Format wird von CRM, SMS-Gateway und CTI sofort erkannt

Integration und Anwendungsfälle

REST-API – schnell eingebunden

Omikrons API lässt sich schnell in Ihr bestehendes System einbinden – egal ob Webformular, CRM oder Backend. Die Anbindung läuft über eine Standard-Schnittstelle (REST) mit einem einfachen Zugangscode. Ihr Entwicklungsteam hat den ersten Prozess in Minuten abgesichert.

Jetzt Demo API Key anfordern

REST-API – schnell eingebunden

Echtzeitvalidierung im Webformular

Ihre Kunden tippen ihre Telefonnummer so ein, wie sie es gewöhnt sind. Omikron prüft im Hintergrund automatisch das Format, ergänzt die Ländervorwahl falls nötig und zeigt das Ergebnis sauber formatiert an. Fehler werden direkt abgefangen – bevor sie ins System gelangen.

Jetzt Demo API Key anfordern

Echtzeitvalidierung im Webformular

Bestandsbereinigung im Batch-Betrieb

Sie haben tausende Telefonnummern in Ihrem CRM, aber in unterschiedlichsten Formaten? Kein Problem: Omikron bereinigt Ihren gesamten Datenbestand auf einmal und schreibt das Ergebnis direkt zurück. Danach sorgt die API dafür, dass neue Nummern von Anfang an sauber bleiben.

Jetzt Demo API Key anfordern

Millionen Telefonnummern im Batch-Betrieb validieren

Bestandsbereinigung im Batch-Betrieb

Telefonnummern validieren - für über 100 Länder

Globale Abdeckung – über 100 Länder

Sie haben Kunden in Deutschland, Österreich, der Schweiz – oder weltweit? Omikron kennt die Telefonnummernsysteme von über 100 Ländern und prüft jede Nummer nach den richtigen Regeln. Kein manueller Aufwand für internationale Kontakte.

Jetzt Demo API Key anfordern

Globale Abdeckung – über 100 Länder

Saubere Rufnummern. Sofort systemtauglich.

TestenSie die Omikron Telefonvalidierungs-API kostenlos und unverbindlich mit Ihreneigenen Daten.

Jetzt API Key anfordern

Für Entwickler: Omikron API in 3 Schritten einbinden

API-Referenz (Swagger/ OpenAPI)

Die Omikron API ist eine REST/OpenAPI-Schnittstelle (OAS 3.0). Kein SDK, kein komplexes Setup – ein einziger HTTP-Call genügt. Die vollständige interaktive Spezifikation steht als interaktive Swagger-UI mit allen Schemas, Parametern und Try-it-out-Funktion bereit:

Stage:
https://api-lumine-stage.omikron.com/swagger/index.htmlSwagger

JSON:
https://api-lumine-stage.omikron.com/swagger/v1/swagger.json

Jetzt Demo API Key anfordern

API-Referenz (Swagger/ OpenAPI)

API-Referenz zur Omikron Telefon-Validierung REST-API

Schritt 1: Authentifizierung

Jeder API-Aufruf erfordert einen API-Key im HTTP-Header. Den Key erhalten Sie nach der Demo-Anfrage von Omikron. Bitte den genauen Header-Namen (z. B. X-Api-Key oder Authorization) aus der aktuellen Swagger-Spezifikation entnehmen.

Schritt 1:Authentifizierung

X-Api-Key: IHR_API_KEY
Content-Type: application/json

Schritt 2: Request

Endpunkt (Stage):
https://api-lumine-stage.omikron.com/v1/services/phonenumber/validate

Schema:
PhoneNumberValidationRequest – Fehlerbeschreibung aus Swagger entnehmen.

Schritt 2: Request

Typisches Minimalbeispiel:

POST /v1/services/phonenumber/validate HTTP/1.1
Host: api-lumine-stage.omikron.com
X-Api-Key: IHR_API_KEY
Content-Type: application/json
 
{
  "phoneNumber": "+43 1 6082981",
  "countryCode": "DE"
}

Schritt 3: Response

HTTP 200 bei erfolgreichem Call. Das Response-Objekt (Schema: PhoneNumberValidationResponse) enthält gemäß Swagger-Beschreibung: normalisierte Formate, Carrier-Informationen und den Nummerntyp.

Schritt 3: Response

Beispiel-Response (Feldnamen bitte aus Swagger entnehmen):

{
  "isValid": true,
  "countryCodeMatch": false,
  "errorMessage": "Found wrong country code <AT> for country <DE>",
  "normalizedNumber": "+43-1/6082981",
  "networkType": "FIXED",
  "region": "Wien",
  "carrier": "..."
}

FAQs

Was prüft die Omikron Telefonvalidierungs-API genau?

Was ist E.164 und warum brauche ich das?

Was passiert, wenn Rufnummer und Adresse unterschiedliche Länder haben?

Werden Tippfehler in der Teilnehmernummer erkannt?

Was ist der HLR-Lookup und wann ist er sinnvoll?

Unterstützt die API internationale Rufnummern?