Telefoonnummer valideren en formatteren API-documentatie

Wereldwijde telefoonnummerinformatie

Eén nummer, consistente uitvoer

Verwerk nationale, internationale en onregelmatig geformatteerde invoer en ontvang vervolgens gestandaardiseerde notaties en validatiemetadata voor 242 landen en gebieden.

Ruwe invoer+1 212 867 5309

E.164-uitvoer+12128675309

ValidatieisValid and isPossible

FormatteringNationaal, internationaal en E.164

ClassificatieMobiel, vaste lijn, VoIP en meer

LocatieRegio, netnummer en plaats

Invoerparameters

Nummer- en adrescontext

Parameter	Vereiste	Beschrijving
`number`	Vereist	Telefoonnummer in nationale, internationale of E.164-notatie.
`address`	Voorwaardelijk	ISO-landcode, landnaam, plaats of regio om een nationaal nummer te interpreteren.

Wanneer address verplicht wordt

Als number niet met + en een internationale landcode begint, geef dan context op, zoals NL, Nederland of Amsterdam.

NLNederlandAmsterdamBelgiëRotterdam

GET

Authenticatie via querystring

Eenvoudige GET-aanvraag

cURL

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

URL-codering: Codeer + als %2B en spaties als %20. Gebruik bij voorkeur de URL- of URLSearchParams-functies van je programmeertaal in plaats van handmatig strings samen te stellen.

POST

Bearer-authenticatie

Server-side POST-aanvraag

Verstuur het nummer en het optionele adres als JSON, met de API-sleutel in de 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":"+12128675309","address":"US"}'

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: "+12128675309", address: "United States" })
});

API-respons

Validatie, formattering en metadata

JSON

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

Responsvelden

Veld	Type	Beschrijving
`status`	boolean	Of de aanvraag succesvol is verwerkt.
`remaining_credits`	integer	Aantal credits dat na de aanvraag beschikbaar blijft.
`expires`	integer	Vervaltijd van de credits als UNIX-tijdstempel.
`duration`	string	Verwerkingstijd op de server.
`regionCode`	string	Gedetecteerde ISO 3166-1 alpha-2-regiocode.
`countryCode`	integer	Internationale landcode voor telefonie.
`country`	string	Leesbare landnaam.
`national`	string	Nummer geformatteerd voor nationaal gebruik.
`international`	string	Nummer geformatteerd voor internationale weergave.
`e164`	string	Canonieke E.164-notatie.
`isValid`	boolean	Of het nummer aan de regionale validatieregels voldoet.
`isPossible`	boolean	Of het nummer op basis van de structuur zou kunnen bestaan.
`numberType`	string	Gedetecteerde nummercategorie.
`nationalSignificantNumber`	string	Nationaal nummer zonder internationale landcode.
`rawInput`	string	Oorspronkelijk nummer uit de aanvraag.
`isGeographical`	boolean	Of het nummer aan een geografisch gebied kan worden gekoppeld.
`areaCode`	string	Gedetecteerd netnummer.
`location`	string	Locatie die aan het netnummer is gekoppeld.

Classificatiereferentie

Waarden voor nummertype

FIXED_LINE

Vaste lijn die aan een geografische locatie is gekoppeld.

MOBILE

Mobiel of cellulair nummer.

FIXED_LINE_OR_MOBILE

Het nummerplan maakt geen onderscheid tussen vast en mobiel.

TOLL_FREE

Gratis nummer waarbij de ontvanger de gesprekskosten betaalt.

PREMIUM_RATE

Servicenummer met verhoogd tarief.

SHARED_COST

Gesprekskosten worden gedeeld door beller en ontvanger.

VOIP

Voice-over-IP-telefoonnummer.

PERSONAL_NUMBER

Persoonlijk nummer dat naar een andere lijn kan doorsturen.

PAGER

Nummer voor pagerberichten.

UAN

Universal Access Number dat als gedeeld zakelijk contact wordt gebruikt.

VOICEMAIL

Speciaal toegangsnummer voor voicemail.

UNKNOWN

De nummercategorie kon niet worden bepaald.

Veelgestelde vragen

FAQ over de telefoon-API

Wat doet de API voor telefoonnummercontrole?

De API valideert en normaliseert telefoonnummers, retourneert nationale, internationale en E.164-notaties en herkent waar beschikbaar de regio, het nummertype en geografische metadata.

Wat is het verschil tussen isValid en isPossible?

isValid controleert het nummer aan de hand van regionale nummerregels; isPossible geeft aan dat de structuur een mogelijk nummer kan vormen, ook wanneer de geldigheid niet kan worden bevestigd.

Wanneer is address verplicht?

Geef address op wanneer het nummer niet met een plusteken en internationale landcode begint. De waarde kan een ISO-landcode, landnaam, plaats of regio zijn.

Hoe moeten speciale tekens worden verzonden?

Codeer spaties, plustekens en andere speciale tekens in GET-queryparameters als URL-code. JSON-POST-bodies worden door je HTTP-client gecodeerd.

Volgende referentie

Bewaak gebruik en quota

Gebruik en quotaBegrijp credits en limieten →ClientbibliothekenInstalleer een pakket voor telefoonvalidatie →