Telefonnummer prüfen & formatieren API

Globale Rufnummernanalyse

Eine Nummer, einheitliche Ausgabeformate

Übermitteln Sie nationale, internationale oder uneinheitlich formatierte Eingaben und erhalten Sie standardisierte Formate sowie Metadaten für 242 Länder und Gebiete.

Eingabe+49 30 901820

E.164-Format+4930901820

ValidierungisValid und isPossible

FormatierungNational, international und E.164

KlassifizierungMobilfunk, Festnetz, VoIP und weitere

StandortRegion, Vorwahl und Ort

Eingabeparameter

Telefonnummer und Ortskontext

Parameter	Status	Beschreibung
`number`	Erforderlich	Telefonnummer im nationalen, internationalen oder E.164-Format.
`address`	Bedingt	ISO-Ländercode, Ländername, Stadt oder Region zur Interpretation einer nationalen Nummer.

Wann ist address erforderlich?

Beginnt number nicht mit + und internationaler Vorwahl, geben Sie Kontext wie DE, Deutschland oder Berlin an.

DEDeutschlandBerlinAustriaVienna

GET

API-Schlüssel im Query-String

Einfache GET-Anfrage

cURL

curl "https://api.genderapi.io/api/phone?key=YOUR_API_KEY&number=%2B4930901820&address=DE"

URL-Kodierung: Kodieren Sie + als %2B und Leerzeichen als %20. Verwenden Sie die URL- oder URLSearchParams-Hilfen Ihrer Programmiersprache.

POST

Bearer-Authentifizierung

Serverseitige POST-Anfrage

Senden Sie Telefonnummer und optionalen Ortskontext als JSON; der API-Schlüssel gehört in den Authorization-Header.

cURL

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

JavaScript

const response = await fetch("https://api.genderapi.io/api/phone", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ number: "+4930901820", address: "DE" })
});

API-Antwort

Validierung, Formate und Metadaten

JSON

{
  "status": true, "remaining_credits": 15709, "expires": 0, "duration": "18ms",
  "regionCode": "DE", "countryCode": 49, "country": "Germany",
  "national": "030 901820", "international": "+49 30 901820", "e164": "+4930901820",
  "isValid": true, "isPossible": true, "numberType": "FIXED_LINE",
  "nationalSignificantNumber": "30901820", "rawInput": "+49 30 901820",
  "isGeographical": true, "areaCode": "30", "location": "Berlin"
}

Antwortfelder

Feld	Typ	Beschreibung
`status`	boolean	Zeigt, ob die Anfrage erfolgreich verarbeitet wurde.
`remaining_credits`	integer	Nach der Anfrage verfügbare Credits.
`expires`	integer	Ablaufzeit der Credits als UNIX-Zeitstempel.
`duration`	string	Verarbeitungszeit auf dem Server.
`regionCode`	string	Erkannter ISO-3166-1-Alpha-2-Regionscode.
`countryCode`	integer	Internationale Ländervorwahl.
`country`	string	Lesbarer Ländername.
`national`	string	Für die nationale Nutzung formatierte Nummer.
`international`	string	Für die internationale Darstellung formatierte Nummer.
`e164`	string	Kanonische Nummer im E.164-Format.
`isValid`	boolean	Ob die Nummer die Nummerierungsregeln der Region erfüllt.
`isPossible`	boolean	Ob die Nummer anhand ihrer Struktur existieren könnte.
`numberType`	string	Erkannte Nummernkategorie.
`nationalSignificantNumber`	string	Nationale Rufnummer ohne internationale Ländervorwahl.
`rawInput`	string	Ursprünglich übermittelte Telefonnummer.
`isGeographical`	boolean	Ob die Nummer einer geografischen Region zugeordnet werden kann.
`areaCode`	string	Erkannte Orts- oder Bereichsvorwahl.
`location`	string	Mit der Vorwahl verknüpfter Ort.

Nummernklassifizierung

Werte von numberType

FIXED_LINE

Geografisch zugeordnete Festnetznummer.

MOBILE

Mobilfunknummer.

FIXED_LINE_OR_MOBILE

Der Nummerierungsplan unterscheidet Festnetz und Mobilfunk nicht.

TOLL_FREE

Für den Anrufer gebührenfreie Nummer.

PREMIUM_RATE

Mehrwertdienstnummer mit erhöhten Gebühren.

SHARED_COST

Nummer mit geteilten Verbindungskosten.

VOIP

Voice-over-IP-Telefonnummer.

PERSONAL_NUMBER

Persönliche Nummer, die auf eine andere Leitung weiterleiten kann.

PAGER

Rufnummer eines Funkrufempfängers.

UAN

Universelle Zugangsnummer eines Unternehmens.

VOICEMAIL

Eigene Zugangsnummer zu einem Voicemail-Dienst.

UNKNOWN

Die Nummernkategorie konnte nicht bestimmt werden.

Häufige Fragen

FAQ zur Telefonnummern-API

Was macht die API zur Telefonnummernprüfung?

Sie validiert und normalisiert Telefonnummern, liefert nationale, internationale und E.164-Formate sowie – sofern verfügbar – Region, Nummerntyp und geografische Metadaten.

Was ist der Unterschied zwischen isValid und isPossible?

isValid prüft die Nummer gegen die Regeln des jeweiligen Nummerierungsplans. isPossible zeigt, dass Aufbau und Länge plausibel sind, auch wenn die vollständige Gültigkeit nicht bestätigt werden kann.

Wann ist address erforderlich?

Geben Sie address an, wenn die Nummer nicht mit Pluszeichen und internationaler Vorwahl beginnt. Zulässig sind beispielsweise ISO-Ländercode, Ländername, Stadt oder Region.

Wie werden Sonderzeichen übermittelt?

Codieren Sie Leerzeichen, Pluszeichen und andere Sonderzeichen in GET-Parametern als URL. Bei einem JSON-POST übernimmt der HTTP-Client die Kodierung.

Nächste Anleitung

Nutzung und Kontingent überwachen

Nutzung und KontingentCredits und Limits verstehen →Client-BibliothekenBibliothek zur Telefonnummernprüfung installieren →