Telefoonnummer Validatie & Formatterings-API

De Phone Validator API wordt ondersteund in 242 landen.

De Telefoonnummer Validatie & Formatterings-API stelt je in staat om eenvoudig telefoonnummers te verwerken die door gebruikers in verschillende formaten zijn ingevoerd. Of het invoerformaat nu zo onregelmatig is als 1(212)-867-53-09, +1 212 8675309, 001-212.867.5309, of gewoon 2128675309, onze API detecteert intelligent de structuur en retourneert een gestandaardiseerde versie.

Deze tool converteert de ingevoerde waarde automatisch naar het E.164-formaat, het wereldwijd erkende formaat voor internationale telefoonnummers. Bijvoorbeeld, +1 212 867 5309 wordt geretourneerd als +12128675309, waardoor het geschikt is voor internationale belsystemen en integraties.

Naast formatteren biedt de API uitgebreide mogelijkheden voor telefoonnummer validatie. Het controleert of het nummer isValid: true is — wat betekent dat het een geldig nummer is volgens nationale nummerplannen. Het geeft ook een isPossible: true status aan, wat aangeeft of een nummer mogelijk zou kunnen bestaan, zelfs als het momenteel niet is toegewezen. Dit is handig voor pre-validatie voordat je gegevens opslaat of verwerkt.

De parameter numberType helpt bij het identificeren of het telefoonnummer een mobiel, vast of VoIP nummer is. Dit is vooral nuttig in situaties waarin je alleen mobiele nummers wilt toestaan voor SMS-verificatie of vaste lijnen voor zakelijke contacten.

Met ondersteuning voor netnummerherkenning kan de API ook de geografische herkomst van het nummer detecteren. Een nummer dat bijvoorbeeld begint met netnummer 212 wordt automatisch gekoppeld aan New York City (Manhattan). Deze functie is perfect voor toepassingen die locatiegebaseerde segmentatie of analyse vereisen.

Elk nummer is ook gekoppeld aan gedetailleerde landmetadata, zoals de ISO-regiocode (bijv. US) en de numerieke landcode (bijv. 1), wat regionale logica en opmaak in je toepassingen mogelijk maakt.

✅ API-respons

Voorbeeld van een JSON-respons:

{
  "status": true,
  "remaining_credits": 15709,
  "expires": 0,
  "duration": "18ms",
  "regionCode": "US",
  "countryCode": 1,
  "country": "Verenigde Staten",
  "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)"
}

Probeer de Telefoon Validatie API Zelf

Basisgebruik

Stuur een telefoonnummer naar het volgende endpoint:

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

Je kunt je dagelijkse gratis API-sleutel met 200 credits verkrijgen via deze link.

Address Parameter

De API ondersteunt ook een optionele address-parameter, die zeer nuttig kan zijn in gevallen waarin het telefoonnummer zonder internationale landcode is opgegeven. Dit veld helpt het systeem om de bedoelde regio te detecteren en het nummer correct te ontleden. Bijvoorbeeld, als het ingevoerde nummer 2128675309 is en er is geen landcode opgegeven, dan kan het instellen van address=US, address=United States of zelfs address=New York de API helpen bepalen dat het nummer tot de Verenigde Staten behoort.

De address-parameter accepteert invoer in meerdere formaten, waaronder:

• ISO 3166-1 alpha-2 codes zoals US, DE of TR
• Landenamen zoals Duitsland, Turkije of Amerika
• Stads- of regiobenamingen zoals Berlijn, Istanboel of New York

Hoewel optioneel, wordt address verplicht als het telefoonnummer niet begint met een plusteken en een internationale landcode (bijv. +1, +44, +90). Zonder deze contextuele informatie kan de API het nationale nummerformaat mogelijk niet correct interpreteren.

Voorbeeld met address-parameter:

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

Responsevelden

Waarden voor 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"

Telefoonvalidatie-API via POST-verzoek

Je kunt de POST-methode gebruiken om een telefoonnummer voor de Verenigde Staten te valideren. Geef eenvoudig het telefoonnummer op in E.164-, nationaal of internationaal formaat, samen met het land/adres. Je API-sleutel moet worden verzonden als een Bearer-token.

cURL Voorbeeld

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 Voorbeeld

<?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 Voorbeeld

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 Voorbeeld

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())

Clientbibliotheken

Om de integratie nog eenvoudiger te maken, bieden we een reeks officiële en door de community ondersteunde clientbibliotheken voor verschillende programmeertalen. Met deze bibliotheken kun je communiceren met de GenderAPI-eindpunten — zoals de Telefoonnummer Validatie-API — zonder handmatig HTTP-verzoeken of JSON-parsing te hoeven afhandelen. Kies gewoon de juiste bibliotheek voor je omgeving, installeer deze en begin met het maken van verzoeken met minimale configuratie.

Je kunt de beschikbare clientbibliotheken en installatie-instructies vinden op de volgende pagina:
https://www.genderapi.io/nl/docs-client-libraries

Veelgestelde Vragen (FAQ)

1. Wat is de Phone Number Validation & Formatter API?

De Phone Number Validation & Formatter API is een tool waarmee je telefoonnummers van over de hele wereld kunt valideren, formatteren en analyseren. Het kan nummers omzetten naar het gestandaardiseerde E.164-formaat en metadata bepalen zoals regio, type (mobiel/vast), geldigheid en meer.

2. Waar wordt de Phone Number Validation voor gebruikt?

Het wordt gebruikt om te controleren of een telefoonnummer geldig is, het te formatteren voor internationaal gebruik, het type nummer te identificeren (bijv. mobiel, VoIP), regiogebonden metadata te detecteren en om te zorgen voor schone, gestandaardiseerde input in CRM-, marketingtools of registratieformulieren.

3. Hoeveel landen worden ondersteund?

De API ondersteunt telefoonnummers uit 242 landen en gebieden wereldwijd. Dit zorgt voor wereldwijde dekking voor elke internationale of regionale toepassing.

4. Welke formaten worden ondersteund?

De API accepteert nummers in diverse formaten zoals nationaal, internationaal of E.164. Het detecteert deze automatisch en normaliseert ze naar het juiste formaat.

5. Wat gebeurt er als ik de land- of adresparameter weglaat?

Als het telefoonnummer niet begint met een '+' en er geen land/adres wordt opgegeven, kan de API het nummer mogelijk niet correct interpreteren. Het is aanbevolen om de address-parameter toe te voegen (zoals US, United States of New York).

6. Kan de API het nummertype detecteren?

Ja. De API retourneert het veld numberType dat aangeeft of het nummer een MOBILE, FIXED_LINE, VOIP, enz. is.

7. Wat is het verschil tussen isValid en isPossible?

isValid betekent dat het nummer officieel is toegewezen en voldoet aan alle regionale regels. isPossible controleert of het nummer theoretisch zou kunnen bestaan op basis van de structuur, zelfs als het nog niet is toegewezen.

8. Wat voor soort respons geeft de API terug?

Een succesvolle respons bevat de status, geformatteerde nummerweergaven (nationaal, internationaal, E.164), regiogegevens, nummertype, creditgebruik en meer. Zie het gedeelte “API-responsvoorbeeld” voor een volledige output.

9. Hoe moet ik mijn API-sleutel versturen?

Voor GET-verzoeken voeg je de sleutel toe als ?key=YOUR_API_KEY. Voor POST-verzoeken gebruik je de Bearer-token in de header, zoals:
"Authorization: Bearer YOUR_API_KEY".

10. Wat als ik een status: false respons zie?

Dit betekent dat het verzoek is mislukt. Het veld message bevat een gedetailleerde foutmelding zoals ontbrekende parameters, een ongeldig telefoonnummer of onvoldoende credits.

11. Zijn speciale tekens of spaties toegestaan in invoer?

Ja, maar ze moeten URL-gecodeerd zijn voor GET-verzoeken. Gebruik bijvoorbeeld %20 in plaats van een spatie. Zie de waarschuwingssectie hierboven voor correct gebruik.

12. Kan ik adressen in verschillende formaten of talen gebruiken?

Ja. Naast ISO 3166-1 alpha-2 codes (zoals US, DE, TR), accepteert de address-parameter ook volledige landnamen of steden — zelfs in andere talen. De API gebruikt ingebouwde AI om het juiste land of de juiste regio intelligent te detecteren. Bijvoorbeeld:

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

Al deze invoer wordt correct gekoppeld aan hun respectieve landen of regio's door de API, zonder problemen.