// operaciones en masa
Validador de Telefonos en Masa
Sube un CSV con numeros de telefono y validalos todos en cuanto a formato y capacidad de entrega de una sola vez.
- 01pending
POST /v1/bulk/phone-validator201 · { "data": { "id": 1042 } } - 02running
launch: trueprogreso consultado con GET /v1/bulk/phone-validator/1042/progress - 03completed
bulk.completedwebhook firmado entregado en tu webhook_url
GET /v1/bulk/phone-validator/1042/download?file=fullSe cobra en la primera descarga · el trabajo caduca a los 180 días// 01 · entrada
La entrada de un trabajo masivo de Phone Validator
Sube un CSV de hasta 4 MB en la app, o envía una lista, filas o un archivo a POST /v1/bulk/phone-validator. Las columnas se detectan a partir de la fila de encabezado; indica un índice de campo para elegir una tú mismo.
/bulk/phone-validatorColumnasphone_field_index, country_field_index- Phone number, country
// 02 · api
Una solicitud inicia el trabajo
Créalo y lánzalo en una sola llamada; después sigue su progreso o recibe un evento firmado bulk.completed. Cada fila de resultado es lo que devuelve 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 · coste y límites
Lo que cuesta un trabajo
Crear o lanzar un trabajo no se cobra. Su coste se cobra una sola vez, en la primera descarga de sus resultados.
- Filas: hasta 10,000 por trabajo
- 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 · úsalo en cualquier parte
Ejecuta trabajos de Phone Validator desde la app o tu código
El mismo trabajo, los mismos créditos: sube un archivo en la app, llama a la API o trabaja desde una hoja de cálculo o una herramienta no-code.
- API RESTJSON sobre HTTPS, 13 SDK, webhooks firmados.
GET /v1/phone-validator - CSV masivoSube una lista en la app o envíala por POST a /bulk; descárgala cuando termine.
POST /v1/bulk/{type} - Zapier, Make, n8nAcciones no-code para el buscador, el verificador y el enriquecimiento.
Zapier · Make · n8n · Pipedream
La referencia completa de la solicitud: /api/bulk/phone-validator
// clientes
Equipos que ejecutan trabajos de 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