Telefonvalidierung, die Ihre Server nie verlässt.
Format, Rufnummerntyp, Anbieter, Region und Zeitzone für jede Nummer in 240+ Ländern — vollständig offline berechnet, ohne dass eine Nummer je an Dritte gesendet wird.
Telefonvalidierung auf Anfrage
Dieses Produkt wird nicht im Selfservice verkauft. Sagen Sie uns, welches Volumen und welche Länder Sie abdecken müssen — wir melden uns per E-Mail. Die vollständige Antwort — jedes Feld, jedes Urteil — ist in der API-Referenz dokumentiert.
Was jedes Ergebnis bedeutet
Jedes Feld, das die /validate-phone-Antwort enthält, und was es über eine Nummer aussagt.
- verdict
- Unser Gesamturteil. valid — die Nummer entspricht einem real zugeteilten Bereich für Land und Rufnummerntyp, sicher zu verwenden. possible — Länge und Form sind plausibel, aber die Nummer liegt noch in keinem zugeteilten Bereich, daher als reine Formatprüfung behandeln. invalid — kann keine echte Nummer sein (zu kurz/lang, falsche Ländervorwahl, ungültig). unknown — die Eingabe war leer oder der Validator nicht verfügbar.
- score
- Ein Erreichbarkeits-Score von 0–10. 10 = gültige Mobilnummer; 8–9 = gültiges Festnetz / Festnetz-oder-Mobil; 6–7 = gültig, aber weniger vertrauenswürdige Rufnummerntypen (VoIP, Servicenummer, Premium); 3 = nur möglich; 0–1 = ungültig. Lässt Ihren Code einfach verzweigen, z. B.
if score < 8: review. - valid
- Boolean — ob die Nummer für ihre Region nach dem offiziellen Nummernplan gültig ist. Das wichtigste Feld zur Steuerung.
- e164
- Die Nummer normalisiert nach E.164 (
+<Land><national>, z. B.+14155552671) — die kanonische Form zum Speichern und Wählen.internationalundnationalwerden ebenfalls zurückgegeben. - line_type
- Welcher Anschlusstyp:
mobile,fixed_line,fixed_line_or_mobile,voip,toll_free,premium_rate,pagerund mehr. Bestimmt, ob SMS überhaupt möglich ist. - region
- Das ISO‑3166-Land, zu dem die Nummer gehört (z. B.
US,DE) — aus der Nummer selbst abgeleitet, nicht aus der Annahme des Anrufers. - carrier
- Bestmöglicher ursprünglicher Anbieter aus dem Nummernplan-Block (z. B.
T-Mobile). Offline und blockbasiert, also der zugeteilte Anbieter, keine Live-Portierungsabfrage — leer, wenn unbekannt. - location
- Eine menschenlesbare geografische Beschreibung der Nummer (z. B.
San Francisco, CAoderBerlin), sofern der Plan dies unterstützt. - timezones
- Die IANA-Zeitzone(n), auf die die Nummer abbildet (z. B.
Europe/Berlin) — nützlich für Sende-Zeitfenster und Anruflogik. - can_receive_sms
true, wenn der Anschluss SMS empfangen kann (Mobil oder Festnetz-oder-Mobil). Steuern Sie OTP-/SMS-Versand darüber, damit nichts an ein Festnetz verschwendet wird.- tel_uri
- Die Nummer als RFC 3966-
tel:-URI (tel:+1-415-555-2671) — direkt für einen Klick-zum-Anrufen-Link. - is_premium_rate / is_toll_free
- Kostenklassen-Kennzeichen — eine Premium- oder gebührenfreie Nummer dort, wo eine normale Mobilnummer erwartet wird. Erkennt falsch eingegebene oder teure Nummern.
- is_short_number / is_emergency
- Die Eingabe ist ein Kurzwahlcode (
112,999, …) oder eine bekannte Notrufnummer — meist Unsinn in einem Kontaktfeld, also mit klarem Grund ablehnbar. - national_number / area_code
- Die nationale Rufnummer (Ziffern nach der Ländervorwahl) und, sofern vorhanden, die Vorwahl — nützlich für Routing und Analysen.
- is_vanity
- Die Eingabe enthielt Buchstaben (z. B.
1-800-FLOWERS); wir wandeln sie vor der Prüfung in Ziffern um. - valid_for_input_region / short_number_cost
- Falls Sie eine Region übergeben: ob die Nummer tatsächlich für dieses Land gültig ist (
false= gehört woanders hin). Bei Kurzwahlcodes die Kostenklasse:toll_free/standard_rate/premium_rate. - dialling
- Mit
dial_from: wie diese Nummer aus dem angegebenen Land gewählt wird (z. B. eine US-Nummer aus DE →00 1 415-555-2671). - is_possible
- Ob die Nummer überhaupt eine plausible Länge/Form für ihre Region hat — eine günstigere Vorprüfung als die volle Gültigkeit.
- reasons
- Maschinenlesbare Codes hinter dem Urteil (z. B.
too_short,invalid_country_code,not_in_assigned_range,no_default_region) — damit Ihr Code programmatisch reagieren kann.
Was wird geprüft — und was nicht
Ehrlichkeit zuerst: Dies ist Tier 1-Validierung — alles wird offline aus dem globalen Nummernplan berechnet, ohne Netzwerkabruf und ohne Kosten pro Abfrage. Sie bestätigt, dass eine Nummer wohlgeformt und gültig ist; sie tätigt keinen Anruf und prüft nicht, ob das Endgerät gerade eingeschaltet ist. Hier verläuft die Grenze genau.
| Das bekommen Sie (offline, Tier 1) | Dafür braucht es ein Live-Add-on (Tier 3) |
|---|---|
| ✅ Gültig für Region & Nummernplan | ☎️ Live-Erreichbarkeit / HLR (jetzt eingeschaltet?) |
| ✅ E.164 + international + national | 📲 Aktueller Anbieter nach Portierung (Echtzeit-MNP) |
| ✅ Rufnummerntyp (Mobil / Festnetz / VoIP / …) | 🪪 Anrufername (CNAM) |
| ✅ Region, Geo-Beschreibung, Zeitzone(n) | 🚩 Betrugs- / SIM-Swap- / Wegwerfnummern-Scoring |
| ✅ Zugeteilter (blockbasierter) Anbieter, 240+ Länder | — |
Warum nur offline? Tier 1 fängt den Großteil schlechter Daten direkt bei der Eingabe ab — Tippfehler, falsches Land, unmögliche Längen, Festnetznummern im „Mobil"-Feld — vollständig offline berechnet, ohne dass PII Ihr System verlässt.
Live-Erreichbarkeit nötig? HLR- / Aktiv-Abfragen erfordern eine Telekom-Datenbeziehung und verursachen echte Kosten pro Abruf, daher gibt es sie als kostenpflichtiges Add-on. Sprechen Sie uns an, wenn Sie das brauchen.
Jede Prüfung, jede Nummer, jedes Mal
E.164-Normalisierung
Jede Eingabe — Leerzeichen, Bindestriche, Klammern, national oder international — kommt als sauberer +<LV><NSN>-String zum Speichern und Wählen zurück.
Nummernplan-Gültigkeit
Bestätigt, dass die Nummer für ihre Region tatsächlich zugeteilt ist, nicht nur plausibel — geprüft gegen den offiziellen globalen Nummernplan.
Rufnummerntyp-Erkennung
mobile / fixed_line / VoIP / toll_free / premium — damit Sie nur Nummern per SMS anschreiben, die eine empfangen können.
Anbieter (offline)
Zugeteilter, blockbasierter Anbieter aus dem Nummernplan (z. B. T-Mobile) — ohne Netzwerkabruf, ohne Gebühr pro Abfrage.
Region & Geo
ISO-Land plus menschenlesbarer Ort (San Francisco, CA · Berlin), aus der Nummer selbst abgeleitet.
Zeitzonen
IANA-Zone(n) für die Nummer — steuern Sende-Zeitfenster und respektieren Ruhezeiten automatisch.
240+ Länder
Eine API, die ganze Welt. Geben Sie eine Standardregion für nationale Nummern an; E.164-Eingaben brauchen nichts.
0–10-Score
Ein einziger numerischer Erreichbarkeits-Score, damit Ihr Code if score < 8: review. Sortierbar, vergleichbar.
Wofür Teams es einsetzen
Checkout & Anmeldung
Erkennen Sie eine vertippte oder falsche Ländernummer schon bei der Eingabe und speichern Sie sie normalisiert als E.164 — damit die „Paket ist unterwegs“-SMS den Kunden erreicht, statt zurückzukommen.
OTP- & 2FA-Versand
Prüfen Sie vor dem Senden eines Einmalpassworts, ob es eine mobile-Nummer ist. Festnetz und viele VoIP-Nummern können keine SMS empfangen — überspringen Sie sie oder weichen Sie auf einen Sprachanruf aus, statt einen Versand zu verschwenden.
CRM- & Verteiler-Bereinigung
Validieren Sie eine importierte Liste in einem Rutsch: unmögliche Nummern entfernen, alle als E.164 normalisieren und Festnetznummern in einer „Mobil“-Spalte markieren — bevor Sie für deren Versand bezahlen.
Rechtskonforme Outbound-Anrufe
Nutzen Sie Region und Zeitzone jeder Nummer, um Anrufe innerhalb der lokalen Geschäftszeiten des Kontakts zu planen — unter Beachtung von Ruhezeiten — und jeden Lead an das passende regionale Team zu leiten.
Günstiger Betrugs-Vorfilter
Weisen Sie offensichtlich falsche Nummern schon bei der Registrierung ab — falsche Ländervorwahl, unmögliche Länge, eine Premium-Nummer statt der erwarteten Mobilnummer — ein günstiger erster Filter vor einer Erreichbarkeits- oder Risikoprüfung.
WhatsApp- & Messaging-Onboarding
Messaging-APIs verlangen saubere E.164-Mobilnummern. Validieren und normalisieren Sie, bevor Sie einen Kontakt zu einer WhatsApp-Business-, RCS- oder SMS-Zielgruppe hinzufügen — damit kein Empfänger stillschweigend verloren geht.
Drei Zeilen, jede Sprache
Ein einzeiliges curl oder derselbe Aufruf direkt aus Node und Python — sauberes JSON, auf jeder Stufe gleich.
curl -X POST 'https://api.acuris-geo.com/validate-phone' \
-H 'X-Acuris-Key: YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"phone": "+1 415 555 2671"}'
# → {
# "phone": "+1 415 555 2671",
# "verdict": "valid",
# "score": 9,
# "e164": "+14155552671",
# "line_type": "fixed_line_or_mobile",
# "region": "US",
# "location": "San Francisco, CA"
# }const res = await fetch("https://api.acuris-geo.com/validate-phone", {
method: "POST",
headers: { "X-Acuris-Key": process.env.ACURIS_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({ phone: "+1 415 555 2671" }),
});
const r = await res.json();
console.log(r.verdict, r.score, r.e164, r.line_type);
// → "valid" 9 "+14155552671" "fixed_line_or_mobile"import os, requests
r = requests.post(
"https://api.acuris-geo.com/validate-phone",
headers={"X-Acuris-Key": os.environ["ACURIS_API_KEY"]},
json={"phone": "+1 415 555 2671"},
).json()
print(r["verdict"], r["score"], r["e164"], r["line_type"])
# → valid 9 +14155552671 fixed_line_or_mobileIndividuell bepreist, auf Anfrage
Die Telefonvalidierung wird nicht im Selfservice verkauft und läuft nicht über einen gemeinsamen Credit-Pool — nennen Sie uns Ihr Volumen und die benötigten Länder, wir nennen Ihnen einen Preis.