// operations en masse
Validateur de Telephones en Masse
Importez un CSV de numeros de telephone et validez-les tous en termes de format et de delivrabilite en une seule fois.
- 01pending
POST /v1/bulk/phone-validator201 · { "data": { "id": 1042 } } - 02running
launch: trueprogression interrogée avec GET /v1/bulk/phone-validator/1042/progress - 03completed
bulk.completedwebhook signé envoyé à votre webhook_url
GET /v1/bulk/phone-validator/1042/download?file=fullFacturé au premier téléchargement · la tâche expire au bout de 180 jours// 01 · entrée
L'entrée d'une tâche Phone Validator en masse
Importez un CSV de 4 Mo maximum dans l'application, ou envoyez une liste, des lignes ou un fichier à POST /v1/bulk/phone-validator. Les colonnes sont détectées à partir de la ligne d'en-tête ; indiquez un index de champ pour en choisir une vous-même.
/bulk/phone-validatorColonnesphone_field_index, country_field_index- Phone number, country
// 02 · api
Une seule requête lance la tâche
Créez-la et lancez-la en un seul appel, puis suivez sa progression ou recevez un événement bulk.completed signé. Chaque ligne de résultat correspond à ce que renvoie GET /phone-validator.
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"]{
"data": {
"id": 1042
}
}{
"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 une tâche
La création ou le lancement d'une tâche ne coûte rien. Son coût est facturé une seule fois, au premier téléchargement des résultats.
// facturation par ligne
1 search credit per valid number.
La facturation des tâches en masse dans la documentation- Lignes : jusqu'à 10,000 par tâche
- 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)
// 04 · utilisable partout
Lancez des tâches Phone Validator depuis l'application ou votre code
La même tâche, les mêmes crédits : importez un fichier dans l'application, appelez l'API, ou travaillez depuis un tableur ou un outil no-code.
- API RESTJSON sur HTTPS, 13 SDK, webhooks signés.
GET /v1/phone-validator - CSV en masseImportez une liste dans l'application ou envoyez-la en POST à /bulk ; téléchargez-la une fois terminée.
POST /v1/bulk/{type} - Zapier, Make, n8nDes actions no-code pour la recherche, la vérification et l'enrichissement.
Zapier · Make · n8n · Pipedream
La référence complète de la requête : /api/bulk/phone-validator
// clients
Les équipes qui lancent des tâches Phone Validator
Tomba is my go-to to validate emails. Even in a waterfall process with multiple tools, Tomba is usually the top choice.
Nuno PoçoSales Automation Architect, clickworks.ioThe data is always fresh, and the n8n integration is excellent. Support is very responsive. I'd rate it 9/10.
Benjie MalinaoCo-Founder & CTO, Channel Automation