// post /v1/bulk/phone-validator
API de validation de téléphone en masse
Validez et normalisez des ensembles de données téléphoniques volumineux dans une opération API asynchrone conçue pour évoluer.
Phone numbers, with an optional countryJusqu'à 10,000 lignes
curl -X POST "https://api.tomba.io/v1/bulk/phone-validator" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Phone Validator job","list":"+16505550132","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/phone-validator", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Phone Validator job",
"list": "+16505550132",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/phone-validator",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Phone Validator job",
"list": "+16505550132",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 01 · requête
Bulk Phone Validator tient en une requête HTTPS
Envoyez les paramètres avec votre clé et votre secret. Chaque SDK, la CLI et le serveur MCP effectuent ce même appel.
- type
- phone-validator
- list | data | file
- Phone numbers, with an optional country
- launch
- true lance la tâche immédiatement
- webhook_url
- Reçoit un événement signé à la fin de la tâche
- rows
- Jusqu'à 10,000 par tâche
curl -X POST "https://api.tomba.io/v1/bulk/phone-validator" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Phone Validator job","list":"+16505550132","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/phone-validator", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Phone Validator job",
"list": "+16505550132",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/phone-validator",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Phone Validator job",
"list": "+16505550132",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 02 · réponse
Ce qui est renvoyé
Du JSON, identique dans tous les langages. Les champs que Tomba ne connaît pas valent null, jamais une supposition.
GET
/phone-validatorChampdataobject | array- The number's details; an empty array, with phone repeating your input, when it isn't valid
data.validboolean | null- Whether the number is a valid phone number
data.intl_format, data.e164_format, data.local_formatstring | null- The number in international, E.164 and national formats
data.country_codestring | null- Country of the number (ISO code)
data.line_typestring | null- MOBILE, FIXED_LINE, FIXED_LINE_OR_MOBILE, VOIP, TOLL_FREE…
data.carrierstring | null- The network operator
data.region, data.timezonesobject | null, array | null- Where the number is registered, and its time zones
POST /bulk/phone-validator
201 Created
{
"data": {
"id": 1042
}
}Chaque ligne, telle que GET /phone-validator la renvoie
200 OK
{
"data": {
"valid": true,
"local_format": "(650) 555-0132",
"intl_format": "+1 650-555-0132",
"e164_format": "+16505550132",
"rfc3966_format": "tel:+1-650-555-0132",
"country_code": "US",
"line_type": "MOBILE",
"carrier": "AT&T",
"region": {
"name": "California",
"code": "CA"
},
"timezones": [
"America/Los_Angeles"
]
}
}// 03 · coût et limites
Ce que coûte un appel
Un appel n'est facturé que dans la condition ci-dessous. Les limites de débit dépendent de votre offre.
// coût
1 search credit per valid number.
Charged once, at the first download; later downloads are free
- Jobs created: 15 per day for each type
- Running jobs: 2 per type
- Downloads: 25 per day for each job
- Request size: 4 MB (CSV, list or rows)
Créez une opération groupée en téléchargeant des numéros de téléphone, puis lancez l'opération. L'API valide chaque numéro de téléphone de manière asynchrone avec des vérifications de format, d'opérateur et de type de ligne.
Vous pouvez valider jusqu'à 100 000 numéros de téléphone par opération groupée. Pour des listes plus volumineuses, créez plusieurs opérations groupées.
Chaque numéro de téléphone est validé pour l'exactitude du format, la correspondance des modèles de pays, l'identification de l'opérateur, la détection du type de ligne (mobile, fixe, VoIP) et la structure du numéro.
Chaque résultat comprend le statut valide, le numéro de téléphone dans plusieurs formats (local, international, E164, RFC3966), l'indicatif du pays, le type de ligne, les informations sur l'opérateur et le fuseau horaire.
La validation est rapide : le traitement typique est de 500 à 1 000 téléphones par minute. Un lot de 100 000 numéros de téléphone est généralement traité en 2 à 3 heures.
L'API accepte les numéros dans différents formats, notamment local, international avec +, E.164, etc. La détection du pays est automatique.
Oui, configurez une URL de webhook pour recevoir une notification lorsque votre validation téléphonique groupée est terminée avec des résultats prêts à être téléchargés.
Une fois le traitement terminé, utilisez le point de terminaison de téléchargement pour obtenir tous les résultats de validation au format CSV ou JSON.
Oui. La validation groupée permet de supprimer les numéros mal formés ou à risque avant le lancement de la campagne, réduisant ainsi le gaspillage et améliorant la qualité des contacts.
Exécutez la validation lors de l'importation, normalisez selon E.164, filtrez par type de ligne ou par règles nationales et revalidez périodiquement les listes obsolètes.