// post /v1/bulk/phone-validator
Bulk Phone Validator API
تحقق من مجموعات أرقام الهاتف الكبيرة ووحّدها في عملية API واحدة غير متزامنة مصممة للتوسع.
Phone numbers, with an optional countryحتى 10,000 صف
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 · الطلب
Phone Validator مجمّع هو طلب HTTPS واحد
أرسل المعاملات مع مفتاحك وسرّك. كل SDK وCLI وخادم MCP ينفّذون هذا الاستدعاء نفسه.
- type
- phone-validator
- list | data | file
- Phone numbers, with an optional country
- launch
- القيمة true تبدأ المهمة فورًا
- webhook_url
- يستقبل حدثًا موقّعًا عند انتهاء المهمة
- rows
- حتى 10,000 لكل مهمة
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 · الاستجابة
ما يُعاد إليك
JSON، متطابقة في كل لغة. الحقول التي لا تعرفها Tomba تكون null، ولا تُخمَّن أبدًا.
GET
/phone-validatordataobject | 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
}
}كل صف، كما يعيده GET /phone-validator
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 · التكلفة والحدود
تكلفة الاستدعاء
لا يُخصم الاستدعاء إلا وفق الشرط أدناه. تعتمد حدود المعدّل على خطتك.
// التكلفة
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)
أنشئ عملية مجمّعة برفع أرقام الهاتف، ثم شغّل العملية. يتحقق API من كل رقم بشكل غير متزامن بفحوصات الصيغة والمشغّل ونوع الخط.
You can validate up to 100,000 phone numbers per bulk operation. For larger lists, create multiple bulk operations.
يُتحقق من كل رقم من حيث صحة الصيغة ومطابقة نمط الدولة وتحديد المشغّل واكتشاف نوع الخط (جوال، أرضي، VoIP) وبنية الرقم.
تتضمن كل نتيجة حالة الصلاحية، ورقم الهاتف بصيغ متعددة (محلية، دولية، E164، RFC3966)، ورمز الدولة، ونوع الخط، ومعلومات المشغّل، والمنطقة الزمنية.
Validation is fast - typical processing is 500-1000 phones per minute. A batch of 100,000 phone numbers typically completes within 2-3 hours.
يقبل API الأرقام بصيغ متنوعة منها المحلية والدولية مع + وE.164 وغيرها. ويُكتشف البلد تلقائيًا.
نعم، اضبط رابط webhook لتتلقى إشعارًا عند اكتمال التحقق المجمّع من الأرقام وجاهزية النتائج للتنزيل.
بعد اكتمال المعالجة، استخدم نقطة نهاية التنزيل للحصول على كل نتائج التحقق بصيغة CSV أو JSON.
نعم. يساعد التحقق المجمّع على استبعاد الأرقام المشوّهة أو الخطرة قبل إطلاق الحملة، مما يقلل الهدر ويحسّن جودة جهات الاتصال.
شغّل التحقق عند الاستيراد، ووحّد الأرقام إلى E.164، وصفِّ حسب نوع الخط أو قواعد الدولة، وأعد التحقق من القوائم القديمة دوريًا.