Telefonnummern-Validierungs- & Formatierungs-API

Die Phone Validator API wird in 242 Ländern unterstützt.

Die Telefonnummern-Validierungs- & Formatierungs-API ermöglicht es Ihnen, Telefonnummern, die von Benutzern in unterschiedlichsten Formaten eingegeben werden, einfach zu verarbeiten. Egal ob die Eingabe so unregelmäßig ist wie 1(212)-867-53-09, +1 212 8675309, 001-212.867.5309 oder einfach 2128675309 – unsere API erkennt intelligent die Struktur und gibt eine standardisierte Version zurück.

Dieses Tool konvertiert die eingegebene Nummer automatisch in das E.164-Format, das international anerkannte Format für Telefonnummern. Zum Beispiel wird +1 212 867 5309 in +12128675309 umgewandelt und ist somit für internationale Telefonsysteme und Integrationen geeignet.

Zusätzlich zum Formatieren bietet die API eine umfassende Validierung von Telefonnummern. Sie prüft, ob die Nummer isValid: true ist – also ob sie gemäß den nationalen Nummerierungsplänen gültig ist. Außerdem gibt es eine isPossible: true-Prüfung, die angibt, ob eine Nummer theoretisch existieren könnte, auch wenn sie derzeit nicht vergeben ist. Dies ist besonders nützlich für Vorabprüfungen vor dem Speichern oder Verarbeiten.

Der Parameter numberType hilft zu erkennen, ob es sich bei der Telefonnummer um eine Mobil-, Festnetz- oder VoIP-Nummer handelt. Das ist besonders hilfreich in Szenarien, in denen z. B. nur Mobilnummern für SMS-Verifizierungen oder nur Festnetznummern für Büroanschlüsse erlaubt sind.

Mit Unterstützung für die Erkennung von Ortsvorwahlen kann die API auch den geografischen Ursprung der Nummer identifizieren. Eine Nummer mit der Vorwahl 212 wird beispielsweise automatisch New York City (Manhattan) zugeordnet. Diese Funktion ist ideal für Anwendungen, die eine ortsbasierte Segmentierung oder Analyse benötigen.

Jede Nummer ist auch mit detaillierten Länder-Metadaten verknüpft, z. B. dem ISO-Region-Code (z. B. US) und dem numerischen Ländercode (z. B. 1), was regionsspezifische Logik und Anzeigeformate in Ihren Anwendungen ermöglicht.

✅ API-Antwort

Beispiel für eine JSON-Antwort:

{
  "status": true,
  "remaining_credits": 15709,
  "expires": 0,
  "duration": "18ms",
  "regionCode": "US",
  "countryCode": 1,
  "country":"Unites States",
  "national": "(212) 867-5309",
  "international": "+1 212-867-5309",
  "e164": "+12128675309",
  "isValid": true,
  "isPossible": true,
  "numberType": "FIXED_LINE_OR_MOBILE",
  "nationalSignificantNumber": "2128675309",
  "rawInput": "+1 212 867 5309",
  "isGeographical": true,
  "areaCode": "212",
  "location": "New York City (Manhattan)"
}

Testen Sie die Phone Validation API selbst

Grundlegende Verwendung

Senden Sie eine Telefonnummer an folgenden Endpunkt:

https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=12128675309

Sie können Ihren täglichen kostenlosen API-Schlüssel mit 200 Credits über diesen Link erhalten.

Adress-Parameter

Die API unterstützt auch einen optionalen address-Parameter, der besonders nützlich ist, wenn die Telefonnummer ohne internationale Landesvorwahl angegeben wird. Dieses Feld hilft dem System, die beabsichtigte Region zu erkennen und die Nummer korrekt zu analysieren. Wenn z. B. die Eingabe 2128675309 lautet und kein Ländercode angegeben ist, kann address=US, address=United States oder sogar address=New York helfen, die Nummer den Vereinigten Staaten zuzuordnen.

Der Parameter address akzeptiert Eingaben in mehreren Formaten, darunter:

• ISO 3166-1 alpha-2-Codes wie US, DE oder TR
• Ländernamen wie Deutschland, Türkei oder Amerika
• Stadt- oder Regionsnamen wie Berlin, Istanbul oder New York

Obwohl optional, wird der address-Parameter verpflichtend, wenn die Telefonnummer nicht mit einem Pluszeichen und einer internationalen Vorwahl beginnt (z. B. +1, +44, +90). Ohne diese Kontextinformation kann die API das nationale Nummernformat möglicherweise nicht korrekt interpretieren.

Beispiel mit Address-Parameter:

https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=12128675309&address=US

Antwortfelder

Werte für Number Type

curl "https://api.genderapi.io/api/phone?number=+49 151 12345678&address=United States&key=YOUR_API_KEY"

curl "https://api.genderapi.io/api/phone?number=%2B49%20151%2012345678&address=United%20States&key=YOUR_API_KEY"

Phone Validation API per POST-Anfrage

Sie können die POST-Methode verwenden, um eine Telefonnummer für die Vereinigten Staaten zu validieren. Geben Sie einfach die Telefonnummer im E.164-, nationalen oder internationalen Format zusammen mit dem Land bzw. der Adresse an. Ihr API-Schlüssel muss als Bearer-Token gesendet werden.

cURL-Beispiel

curl -X POST "https://api.genderapi.io/api/phone" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"number": "+12128675309", "address": "US"}'

PHP cURL Example

<?php
$url = "https://api.genderapi.io/api/phone";

$data = array(
    "number" => "+12128675309",
    "address" => "US"
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

JavaScript-Fetch-Beispiel

fetch("https://api.genderapi.io/api/phone", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    number: "+12128675309",
    address: "United States"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python-requests-Beispiel

import requests

url = "https://api.genderapi.io/api/phone"

payload = {
    "number": "+12128675309",
    "address": "United States"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Client-Bibliotheken

Um die Integration noch einfacher zu machen, bieten wir eine Reihe offizieller und von der Community unterstützter Client-Bibliotheken für verschiedene Programmiersprachen an. Diese Bibliotheken ermöglichen es Ihnen, mit den GenderAPI-Endpunkten – wie der Telefonnummern-Validierungs-API – zu interagieren, ohne manuell HTTP-Anfragen senden oder JSON-Daten verarbeiten zu müssen. Wählen Sie einfach die passende Bibliothek für Ihre Umgebung aus, installieren Sie sie und beginnen Sie mit minimalem Aufwand.

Eine Übersicht über die verfügbaren Client-Bibliotheken sowie Installationsanweisungen finden Sie auf folgender Seite:
https://www.genderapi.io/de/docs-client-libraries

Häufig gestellte Fragen (FAQ)

1. Was ist die Phone Number Validation & Formatter API?

Die Phone Number Validation & Formatter API ist ein Tool, mit dem Sie Telefonnummern aus der ganzen Welt validieren, formatieren und analysieren können. Es konvertiert Nummern in das standardisierte E.164-Format und ermittelt Metadaten wie Region, Typ (Mobil/Festnetz), Gültigkeit und mehr.

2. Wofür wird die Telefonnummernvalidierung verwendet?

Sie wird verwendet, um zu überprüfen, ob eine Telefonnummer gültig ist, sie für internationale Verwendung zu formatieren, den Typ zu identifizieren (z. B. Mobil, VoIP), regionsbezogene Metadaten zu erkennen und eine saubere, standardisierte Eingabe für CRM, Marketingtools oder Benutzeranmeldungen sicherzustellen.

3. Wie viele Länder werden unterstützt?

Die API unterstützt Telefonnummern aus 242 Ländern und Regionen weltweit. Damit ist eine globale Abdeckung für internationale und regionale Anwendungen gewährleistet.

4. Welche Formate werden unterstützt?

Die API akzeptiert Nummern in verschiedenen Formaten wie national, international oder E.164. Sie erkennt und normalisiert sie automatisch in das korrekte Format.

5. Was passiert, wenn ich das Land oder den Adressparameter weglasse?

Wenn die Telefonnummer nicht mit einem '+' beginnt und kein Land bzw. keine Adresse angegeben ist, kann die API die Nummer möglicherweise nicht korrekt interpretieren. Es wird empfohlen, den address-Parameter (z. B. US, United States oder New York) mitzusenden.

6. Kann die API den Nummerntyp erkennen?

Ja. Die API gibt das Feld numberType zurück, das angibt, ob es sich um eine MOBILE-, FIXED_LINE-, VOIP-Nummer usw. handelt.

7. Was ist der Unterschied zwischen isValid und isPossible?

isValid bedeutet, dass die Nummer offiziell vergeben ist und allen regionalen Regeln entspricht. isPossible prüft, ob die Nummer theoretisch existieren könnte, basierend auf ihrer Struktur – auch wenn sie noch nicht zugewiesen ist.

8. Welche Antwort liefert die API?

Eine erfolgreiche Antwort enthält Status, formatierte Nummernvarianten (national, international, E.164), Regionsdaten, Nummerntyp, Credit-Verbrauch und mehr. Siehe den Abschnitt „API-Antwortbeispiel“ für ein vollständiges Beispiel.

9. Wie sende ich meinen API-Schlüssel?

Bei GET-Anfragen fügen Sie den Schlüssel als ?key=YOUR_API_KEY an. Bei POST-Anfragen verwenden Sie das Bearer-Token im Header wie folgt:
"Authorization: Bearer YOUR_API_KEY".

10. Was bedeutet eine Antwort mit status: false?

Das bedeutet, dass die Anfrage fehlgeschlagen ist. Das Feld message enthält dann eine detaillierte Fehlermeldung, z. B. fehlende Parameter, ungültige Telefonnummer oder unzureichende Credits.

11. Sind Sonderzeichen oder Leerzeichen in der Eingabe erlaubt?

Ja, aber sie müssen bei GET-Anfragen URL-codiert sein. Verwenden Sie z. B. %20 anstelle eines Leerzeichens. Weitere Informationen finden Sie im obigen Warnhinweis zur korrekten Verwendung.

12. Kann ich Adressen in verschiedenen Formaten oder Sprachen verwenden?

Ja. Neben den ISO 3166-1 alpha-2-Codes (z. B. US, DE, TR) akzeptiert der address-Parameter auch vollständige Ländernamen oder Städtenamen – auch in verschiedenen Sprachen. Die API nutzt integrierte KI, um das korrekte Land oder die Region intelligent zu erkennen. Zum Beispiel:

address=Deutschland
address=États-Unis
address=İstanbul
address=New York
address=Estados Unidos

All diese Eingaben werden von der API korrekt den jeweiligen Ländern oder Regionen zugeordnet – ganz ohne Probleme.