Unsere API lässt sich schnell und einfach integrieren — in weniger als 15 Minuten einsatzbereit. Außerdem erhalten Sie täglich 50 kostenlose Anfragen zum Start.
Alle API-Anfragen müssen mit der POST-Methode gesendet werden. Der Basis-Endpunkt für alle Anfragen ist:
https://numvalid.com/api/v1/[api_key]
Ersetzen Sie [api_key] durch Ihren persönlichen API-Schlüssel. Alle Anfrageparameter müssen im Request-Body als JSON gesendet werden. Den API-Schlüssel erhalten Sie in Ihrem Dashboard nach der Registrierung.
Methode: test
Diese Methode dient zum Testen der API-Verbindung. Sie überprüft, ob Ihr API-Schlüssel gültig ist und ob der Dienst erreichbar ist. Wenn alles korrekt konfiguriert ist, gibt die API eine erfolgreiche Antwort zurück.
Beispielanfrage
{
"method": "test"
}Erfolgreiche Antwort
{
"error": 0,
"message": "Yippee-ki-yay"
}
Antwortfelder
error — Fehlercode (0 bedeutet, dass die Anfrage erfolgreich war)
message — Antwortnachricht der API
Methode: info
Die Methode info liefert Informationen über Ihr Konto und das aktuelle Abonnement, einschließlich der Anzahl der verwendeten API-Anfragen.
Beispielanfrage
{
"method": "info"
}Erfolgreiche Antwort
{
"error": 0,
"name": "John",
"surname": "Smith",
"email": "[email protected]",
"subscription": "Growth",
"count_request": 2349
}
Antwortfelder
error — Fehlercode (0 bedeutet, dass die Anfrage erfolgreich war)
name — Vorname des Kontoinhabers
surname — Nachname des Kontoinhabers
email — E-Mail-Adresse des Kontos
subscription — aktueller Abonnementplan
count_request — Anzahl der API-Anfragen im aktuellen Abonnementzeitraum
Methode: verify
Die Methode verify prüft eine Telefonnummer und gibt detaillierte Validierungsinformationen zurück.
Telefonnummern können in jedem Format übergeben werden. Die API verarbeitet automatisch Zeichen wie (, ), -, + und Leerzeichen.
Beispielanfrage
{
"phone": "491609502065",
"method": "verify"
}Erfolgreiche Antwort
{
"error": 0,
"request_phone": "491609502065",
"valid_phone": true,
"type": "mobile",
"format": {
"local": "01609502065",
"international": "+491609502065"
},
"country": {
"code": "DE",
"name": "Germany (Federal Republic of)",
"prefix": "+49"
},
"requests": {
"subscription": "Growth",
"count": 2,
"start": "2026-04-06 10:29:40",
"finish": "2026-10-06 10:29:40",
"limit": 9000
}
}
Antwortfelder
error — Fehlercode (0 bedeutet, dass die Anfrage erfolgreich war)
request_phone — in der Anfrage gesendete Telefonnummer
valid_phone — Validierungsergebnis (true, wenn die Nummer gültig ist)
type — Telefonnummerntyp (z. B. Mobil, Festnetz usw.)
Format-Objekt
local — Telefonnummer im lokalen Format
international — Telefonnummer im internationalen Format
Länder-Objekt
code — ISO-Ländercode
name — Ländername
prefix — internationale Vorwahl
Requests-Objekt
Informationen über die aktuelle Nutzung Ihres Abonnements.
subscription — aktiver Abonnementplan
count — Anzahl der bereits verwendeten Anfragen
start — Startdatum des Abonnementzeitraums
finish — Enddatum des Abonnementzeitraums
limit — maximale Anzahl erlaubter Anfragen im Abonnementzeitraum
Fragen zur API-Dokumentation? Kontaktieren Sie uns: