API de validation et formatage des numéros de téléphone

Informations téléphoniques mondiales

Un numéro, une sortie cohérente

Acceptez une saisie nationale, internationale ou irrégulière et obtenez des formats normalisés ainsi que des données de validation pour 242 pays et territoires.

Saisie d’origine+33 1 42 68 53 00

Sortie E.164+33142685300

ValidationisValid et isPossible

FormatageNational, international et E.164

ClassificationMobile, fixe, VoIP et plus

LocalisationRégion, indicatif et lieu

Paramètres d’entrée

Numéro et contexte régional

Paramètre	Statut	Description
`number`	Obligatoire	Numéro au format national, international ou E.164.
`address`	Conditionnel	Code ISO, pays, ville ou région permettant d’interpréter un numéro national.

Quand address est obligatoire

Si number ne commence pas par + et un indicatif international, ajoutez un contexte comme FR, France ou Paris.

FRFranceParisBelgiqueMontréal

GET

Authentification par chaîne de requête

Requête GET simple

cURL

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

Encodage URL : Encodez + en %2B et les espaces en %20. Utilisez URL/URLSearchParams plutôt que de construire la chaîne manuellement.

POST

Authentification Bearer

Requête POST côté serveur

Envoyez le numéro et l’adresse facultative en JSON, avec la clé API dans l’en-tête Authorization.

cURL

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

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: "+33142685300", address: "France" })
});

Protection des données : N’envoyez que les numéros nécessaires à votre traitement et protégez les journaux applicatifs contenant des données téléphoniques.

Réponse de l’API

Validation, formats et métadonnées

JSON

{
 "status": true, "remaining_credits": 15709, "expires": 0, "duration": "18ms",
 "regionCode": "FR", "countryCode": 33, "country": "France",
 "national": "01 42 68 53 00", "international": "+33 1 42 68 53 00", "e164": "+33142685300",
 "isValid": true, "isPossible": true, "numberType": "FIXED_LINE",
 "nationalSignificantNumber": "142685300", "rawInput": "+33 1 42 68 53 00",
 "isGeographical": true, "areaCode": "1", "location": "Paris"
}

Champs de la réponse

Champ	Type	Description
`status`	boolean	Indique si la requête a été traitée correctement.
`remaining_credits`	integer	Crédits disponibles après la requête.
`expires`	integer	Date d’expiration des crédits sous forme d’horodatage UNIX.
`duration`	string	Temps de traitement côté serveur.
`regionCode`	string	Code de région ISO 3166-1 alpha-2 détecté.
`countryCode`	integer	Indicatif téléphonique international.
`country`	string	Nom du pays.
`national`	string	Numéro formaté pour un usage national.
`international`	string	Numéro formaté pour un affichage international.
`e164`	string	Représentation canonique au format E.164.
`isValid`	boolean	Indique si le numéro respecte les règles régionales.
`isPossible`	boolean	Indique si la structure du numéro pourrait être valide.
`numberType`	string	Catégorie détectée du numéro.
`nationalSignificantNumber`	string	Numéro national sans indicatif pays.
`rawInput`	string	Numéro transmis à l’origine dans la requête.
`isGeographical`	boolean	Indique si le numéro peut être associé à une zone géographique.
`areaCode`	string	Indicatif régional détecté.
`location`	string	Localisation associée à l’indicatif régional.

Référence de classification

Types de numéros de téléphone

FIXED_LINE

Ligne fixe associée à une zone géographique.

MOBILE

Numéro de téléphone mobile.

FIXED_LINE_OR_MOBILE

Le plan de numérotation ne distingue pas ligne fixe et mobile.

TOLL_FREE

Numéro gratuit dont le coût est pris en charge par le destinataire.

PREMIUM_RATE

Numéro de service surtaxé.

SHARED_COST

Le coût est partagé entre l’appelant et le destinataire.

VOIP

Numéro de téléphonie sur internet.

PERSONAL_NUMBER

Numéro personnel pouvant rediriger vers une autre ligne.

PAGER

Numéro de radiomessagerie.

UAN

Numéro d’accès universel utilisé comme contact partagé d’une entreprise.

VOICEMAIL

Numéro dédié à l’accès à une messagerie vocale.

UNKNOWN

La catégorie du numéro n’a pas pu être déterminée.

Questions fréquentes

Questions sur l’API téléphonique

Que fait l’API de validation téléphonique ?

Elle valide et normalise les numéros, renvoie les formats national, international et E.164, puis identifie la région, le type et les données géographiques lorsqu’elles sont disponibles.

Quelle différence entre isValid et isPossible ?

isValid vérifie le numéro selon les règles régionales ; isPossible indique que sa structure pourrait correspondre à un numéro sans confirmer sa validité.

Quand le paramètre address est-il obligatoire ?

Ajoutez address lorsque le numéro ne commence pas par le signe plus et un indicatif international. La valeur peut être un code ISO, un pays, une ville ou une région.

Comment transmettre les caractères spéciaux ?

Encodez les espaces, les signes plus et les autres caractères spéciaux dans les paramètres GET. Votre client HTTP encode les corps JSON des requêtes POST.

Référence suivante

Suivez l’utilisation et le quota

Utilisation et quotaComprendre les crédits et les limites →Bibliothèques clientesInstaller un package de validation téléphonique →