انتقل إلى المحتوى
شعار الموقعTextVerification
المطورون

وثائق API

اطلب الأرقام، واقرأ الرموز، وأدِر الإيجارات من الكود الخاص بك. تستخدم واجهة API الرصيد والأسعار نفسها المعتمدة في لوحة التحكم، لكل المنتجات.

  • REST وJSON عبر HTTPS
  • مفتاح API كرمز Bearer
  • استدعاء عكسي مع إعادة المحاولة
  • 100 طلب في الدقيقة
  • أسعار لوحة التحكم نفسها

البدء

كل ما تحتاج إليه قبل طلبك الأول: العنوان، والمصادقة، وصيغة الاستجابة، والأخطاء التي قد تظهر لك.

عنوان URL الأساسي

https://textverification.io/api/v1/users

المصادقة

أرسل مفتاح API الخاص بك كرمز Bearer: Authorization: Bearer YOUR_API_KEY. أنشئ مفتاحًا من إعدادات حسابك، واحتفظ به على خادمك: فأي شخص يملكه يمكنه إنفاق رصيدك.

الطلبات والاستجابات

أرسل متن الطلب بصيغة JSON (حقول النماذج تعمل أيضًا). كل استجابة بصيغة JSON تتضمن statusCode وsuccess وmessage وdata؛ والأسعار بالدولار الأمريكي، كسلاسل نصية بمنزلتين عشريتين.

بداية سريعة

اطلب رقم Pinpoint واقرأ رمزه. وتعمل بقية المنتجات بالطريقة نفسها.

cURL
curl -X POST "https://textverification.io/api/v1/users/request-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1fe58df2"}'
Node.js
const API = "https://textverification.io/api/v1/users";
const headers = {
  Authorization: `Bearer ${process.env.API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Order a number
const order = await fetch(`${API}/request-s2-service`, {
  method: "POST",
  headers,
  body: JSON.stringify({ serviceId: "1fe58df2" }),
}).then((res) => res.json());

// 2. Read the order (or set a callback URL instead of polling)
const { data } = await fetch(
  `${API}/number-details-s2?orderId=${order.data.orderId}`,
  { headers }
).then((res) => res.json());
Python
import os, requests

API = "https://textverification.io/api/v1/users"
headers = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

# 1. Order a number
order = requests.post(f"{API}/request-s2-service",
                      json={"serviceId": "1fe58df2"}, headers=headers).json()

# 2. Read the order (or set a callback URL instead of polling)
details = requests.get(f"{API}/number-details-s2",
                       params={"orderId": order["data"]["orderId"]},
                       headers=headers).json()
print(details["data"]["status"], details["data"]["pin"])

الأخطاء

الحالةالوصف
400الطلب غير صالح، أو رصيدك لا يكفي لهذا الشراء.
401مفتاح API مفقود أو غير صالح أو غير نشط.
403غير مسموح حاليًا، مثلًا بسبب كثرة الطلبات المفتوحة أو تقييد الحساب.
404الطلب أو الخدمة غير موجود، أو لا يخصك.
409لا يمكن تغيير الطلب الآن (مكتمل أو ملغى مسبقًا)، أو تغيّر سعره للتو.
422أحد الخيارات غير صالح، مثل رمز منطقة أو مدة إيجار غير معروفة.
429طلبات كثيرة جدًا: خفّف الوتيرة وحاول مجددًا بعد قليل.
503المنتج غير متاح حاليًا. حاول لاحقًا أو استخدم منتجًا آخر.

فضّل الاستدعاء العكسي على الاستطلاع المتكرر: فهو يصل إلى خادمك لحظة وصول الرمز. وإذا كنت تستطلع حالة طلب، فانتظر بضع ثوانٍ بين الطلبات.

حدود معدل الطلبات

يمكن لكل عنوان IP إرسال ما يصل إلى 100 طلب في الدقيقة، ولكل مفتاح API ما يصل إلى 600 طلب في الدقيقة من جميع العناوين معًا. تحمل كل استجابة الترويستين RateLimit-Remaining وRateLimit-Reset. يتلقى الطلب الذي يتجاوز الحد الحالة 429 مع ترويسة Retry-After تحدد عدد الثواني التي يجب انتظارها. والاستدعاء العكسي يبقيك أدنى من الحد بكثير.

حافظ على أمان تكاملك

  • احتفظ بمفتاح API على خادمك: لا تضعه أبدًا في تطبيق جوال أو في كود المتصفح أو في مستودع عام.
  • إذا كان هناك احتمال لتسرّب مفتاحك، فأنشئ مفتاحًا جديدًا من إعدادات حسابك. ويتوقف المفتاح القديم عن العمل فورًا.
  • يجب أن تستخدم عناوين URL للاستدعاء العكسي بروتوكول HTTPS. أضف إلى المسار سلسلة سرية يصعب تخمينها، وتحقّق من أن كل orderId يخص طلبًا قدّمته قبل أن تتصرف بناءً عليه.
  • يُنفق مفتاحك من رصيدك: تحقّق منه عبر نقطة نهاية الرصيد، واشحن رصيدك قبل الدفعات الكبيرة من الطلبات.

الاستعلام عن رصيدك

يُعيد رصيد حسابك بالدولار الأمريكي.

GET/balance
مثال على الطلب
curl "https://textverification.io/api/v1/users/balance" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": "120.50",
  "message": "Request Successful!",
  "success": true
}

Prime

أرقام أمريكية مع إمكانية اختيار الولاية، وطلبات مميزة للخدمات النافدة.

عرض الخدمات والأسعار

يعرض خدمات Prime مع سعرك لكل منها، بعد الخصم.

GET/server1-pricing
مثال على الطلب
curl "https://textverification.io/api/v1/users/server1-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "2264119e",
      "serviceName": "WhatsApp",
      "price": "1.30"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

تسعير خدمة مع خيارات

يُعيد سعرك لخدمة واحدة مع الخيارات التي ستطلب بها.

GET/server1-price
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
areaCodestringلارمز منطقة أمريكي من 3 أرقام مثل "212"، للحصول على رقم منه. له الأولوية على الولاية وقد يزيد السعر.
requestPremiumnumberلاعلاوة للخدمات النافدة: ينتظر الطلب بحالة «معلّق» ويفوز برقم عند توفره.
مثال على الطلب
curl "https://textverification.io/api/v1/users/server1-price?serviceId=2264119e&areaCode=212&requestPremium=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "serviceId": "2264119e",
    "serviceName": "WhatsApp",
    "areaCode": "212",
    "requestPremium": 20,
    "price": "1.56"
  },
  "message": "Request Successful!",
  "success": true
}

عرض الولايات الأمريكية

يعرض الولايات الأمريكية التي يمكنك طلبها.

GET/us-states
مثال على الطلب
curl "https://textverification.io/api/v1/users/us-states" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "CA": "CA",
    "FL": "FL",
    "NY": "NY",
    "TX": "TX"
  },
  "message": "Request Successful!",
  "success": true
}

طلب رقم

يطلب رقم Prime لخدمة ما ويخصم ثمنه من رصيدك.

POST/request-s1-service
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
statestringلارمز ولاية أمريكية مثل "NY"، للحصول على رقم من تلك الولاية.
areaCodestringلارمز منطقة أمريكي من 3 أرقام مثل "212"، للحصول على رقم منه. له الأولوية على الولاية وقد يزيد السعر.
requestPremiumnumberلاعلاوة للخدمات النافدة: ينتظر الطلب بحالة «معلّق» ويفوز برقم عند توفره.

مع العلاوة، ينتظر الطلب على الخدمة النافدة بحالة «معلّق»؛ وتتلقى استدعاءً عكسيًا s1_win_premium_request عندما يفوز برقم.

مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"2264119e","state":"NY"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "status": "reserved",
    "state": "NY",
    "areaCode": "",
    "requestPremium": 0,
    "price": "1.30",
    "expiredIn": 900
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على طلب

يُعيد الطلب بحالته، والرمز بمجرد وصوله.

GET/number-details-s1
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/number-details-s1?orderId=55655059" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "country": "United States",
    "state": "NY",
    "areaCode": "",
    "price": "1.30",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

إعادة استخدام رقم

يطلب الرقم نفسه مجددًا لاستلام رمز آخر، إذا كانت الخدمة تسمح بذلك.

POST/reuse-s1-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reuse-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"55655059"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "country": "United States",
    "state": "NY",
    "areaCode": "",
    "price": "1.30",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء رقم

يلغي رقمًا لم يستلم رمزًا بعد ويعيد ثمنه إلى رصيدك.

POST/reject-s1-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reject-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"55655059"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Pinpoint

أرقام أمريكية برموز المناطق وشركات الاتصالات التي تختارها، مع استلام الرمز عبر SMS أو، حيثما يتوفر، عبر مكالمة صوتية.

عرض الخدمات والأسعار

يعرض خدمات Pinpoint مع سعرك لكل منها، بعد الخصم.

GET/server2-pricing
مثال على الطلب
curl "https://textverification.io/api/v1/users/server2-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "1fe58df2",
      "serviceName": "google"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

تسعير خدمة مع خيارات

يُعيد سعرك لخدمة واحدة مع الخيارات التي ستطلب بها.

GET/server2-price
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
areasstringلارموز المناطق المطلوبة، مفصولة بفواصل (حتى 10)، مثل "212,646". وهي تزيد السعر.
carrierstringلاشركات الاتصالات المطلوبة، مفصولة بفواصل: tmo (T-Mobile)، vz (Verizon)، att (AT&T). وهي تزيد السعر.
capabilitystringلا"sms" (الافتراضي)، أو "voice" لاستلام الرمز عبر مكالمة حيثما تتوفر المكالمات الصوتية.
مثال على الطلب
curl "https://textverification.io/api/v1/users/server2-price?serviceId=1fe58df2&areas=212%2C646&carrier=vz" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "serviceName": "google",
    "price": "1.53",
    "capability": "sms",
    "areaCode": true,
    "carrier": true
  },
  "message": "Request Successful!",
  "success": true
}

عرض رموز المناطق

يعرض رموز المناطق الأمريكية التي يمكنك طلبها، مع ولاياتها.

GET/server2-area-codes
مثال على الطلب
curl "https://textverification.io/api/v1/users/server2-area-codes" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "areaCode": "212",
      "state": "New York"
    },
    {
      "areaCode": "503",
      "state": "Oregon"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

طلب رقم

يطلب رقم Pinpoint لخدمة ما ويخصم ثمنه من رصيدك.

POST/request-s2-service
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
areasstringلارموز المناطق المطلوبة، مفصولة بفواصل (حتى 10)، مثل "212,646". وهي تزيد السعر.
carrierstringلاشركات الاتصالات المطلوبة، مفصولة بفواصل: tmo (T-Mobile)، vz (Verizon)، att (AT&T). وهي تزيد السعر.
capabilitystringلا"sms" (الافتراضي)، أو "voice" لاستلام الرمز عبر مكالمة حيثما تتوفر المكالمات الصوتية.

يُجاب عن الطلبات الصوتية (capability "voice") باستخدام Voice SDK من Twilio ورمز الوصول من نقطة نهاية رمز المكالمة الصوتية. ويكتمل الطلب عند وصول المكالمة، وتتضمن تفاصيله المكالمة.

مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1fe58df2","areas":"212,646","carrier":"vz,att"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "status": "reserved",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على طلب

يُعيد الطلب بحالته، والرمز بمجرد وصوله.

GET/number-details-s2
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/number-details-s2?orderId=lr_01K7ABC" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "country": "United States",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

إعادة استخدام رقم

يطلب الرقم نفسه مجددًا لاستلام رمز آخر، إذا كانت الخدمة تسمح بذلك.

POST/reuse-s2-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reuse-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"lr_01K7ABC"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "country": "United States",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء رقم

يلغي رقمًا لم يستلم رمزًا بعد ويعيد ثمنه إلى رصيدك.

POST/reject-s2-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reject-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"lr_01K7ABC"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

الحصول على رمز وصول للمكالمة الصوتية

يُعيد رمز وصول قصير الأجل لاستقبال مكالمة طلب صوتي باستخدام Voice SDK من Twilio.

GET/s2-voice-token
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/s2-voice-token?orderId=lr_01K7ABC" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "token": "eyJhbGciOi…",
    "expiresIn": 540
  },
  "message": "Request Successful!",
  "success": true
}

تنزيل تسجيل المكالمة

يُعيد تسجيل مكالمة الطلب الصوتي، إن كان قد حُفظ.

GET/s2-voice-recording
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
callIdstringنعممعرّف المكالمة، من مكالمات الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/s2-voice-recording?orderId=lr_01K7ABC&callId=call_8f2" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
(audio file)

Flex

عدة رموز مناطق وشركة اتصالات في طلب واحد، في الولايات المتحدة ودول أخرى متاحة.

عرض الخدمات والأسعار

يعرض خدمات Flex مع سعرك لكل منها، بعد الخصم.

GET/server3-pricing
المعلمةالنوعمطلوبالوصف
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl "https://textverification.io/api/v1/users/server3-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "9a1c55e0",
      "serviceName": "Telegram",
      "price": "0.40"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

عرض الدول

يعرض الدول التي يبيع فيها Flex أرقامًا، مع رموزها.

GET/server3-countries
مثال على الطلب
curl "https://textverification.io/api/v1/users/server3-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

طلب رقم

يطلب رقم Flex لخدمة ما ويخصم ثمنه من رصيدك.

POST/request-s3-service
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
areasstringلارموز المناطق، مفصولة بفواصل (حتى 10). وهي تزيد السعر.
carrierstringلا"att" أو "tmo". ويزيد السعر.
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"9a1c55e0","areas":"212,646","carrier":"tmo"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "status": "reserved",
    "areas": "212,646",
    "carrier": "tmo",
    "price": "0.58",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على طلب

يُعيد الطلب بحالته، والرمز بمجرد وصوله.

GET/number-details-s3
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/number-details-s3?orderId=48211973" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.58",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

إعادة استخدام رقم

يطلب الرقم نفسه مجددًا لاستلام رمز آخر، إذا كانت الخدمة تسمح بذلك.

POST/reuse-s3-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reuse-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"48211973"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.58",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء رقم

يلغي رقمًا لم يستلم رمزًا بعد ويعيد ثمنه إلى رصيدك.

POST/reject-s3-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reject-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"48211973"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Global

أرقام من دول كثيرة: اعرض قائمة الدول، ثم اطلب رقمًا لخدمة في إحداها.

عرض الخدمات والأسعار

يعرض خدمات Global مع سعرك لكل منها، بعد الخصم.

GET/server4-pricing
المعلمةالنوعمطلوبالوصف
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl "https://textverification.io/api/v1/users/server4-pricing?country=gb" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "c41e7a02",
      "serviceName": "WhatsApp",
      "price": "0.35"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

عرض الدول

يعرض الدول التي يبيع فيها Global أرقامًا، مع رموزها.

GET/server4-countries
مثال على الطلب
curl "https://textverification.io/api/v1/users/server4-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    },
    {
      "code": "gb",
      "name": "United Kingdom"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

الحصول على خيارات التحقق وشركات الاتصالات

يبيّن إن كان يمكن التحقق من خدمة عبر FlashCall + SMS في دولة ما، وشركات الاتصالات التي قد تأتي منها الأرقام، مع سعر كل خيار.

GET/server4-options
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl "https://textverification.io/api/v1/users/server4-options?serviceId=c41e7a02&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "price": "2.70",
    "call": {
      "price": "3.00"
    },
    "carriers": {
      "surcharge": 20,
      "operators": [
        {
          "code": "at_t",
          "name": "AT&T"
        },
        {
          "code": "tmobile",
          "name": "T-Mobile"
        },
        {
          "code": "verizon",
          "name": "Verizon"
        }
      ],
      "price": "3.24",
      "callPrice": "3.60"
    }
  },
  "message": "Request Successful!",
  "success": true
}

طلب رقم

يطلب رقم Global لخدمة ما ويخصم ثمنه من رصيدك.

POST/request-s4-service
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
verificationstringلا"call" لـ FlashCall + SMS: تتصل الخدمة بالرقم ويكون الرقم المتصل هو الرمز. القيمة الافتراضية "sms".
operatorstringلارمز شركة اتصالات من نقطة الخيارات، للحصول على رقم منها فقط. يضيف رسوم اختيار شركة الاتصالات. أي شركة افتراضيًا.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"c41e7a02","country":"us","operator":"tmobile"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "3.24",
    "expiredIn": 1200,
    "carrier": "T-Mobile"
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على طلب

يُعيد الطلب بحالته، والرمز بمجرد وصوله.

GET/number-details-s4
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/number-details-s4?orderId=3311842" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.24",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

إعادة استخدام رقم

يطلب الرقم نفسه مجددًا لاستلام رمز آخر، إذا كانت الخدمة تسمح بذلك.

POST/reuse-s4-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reuse-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"3311842"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.24",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء رقم

يلغي رقمًا لم يستلم رمزًا بعد ويعيد ثمنه إلى رصيدك.

POST/reject-s4-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reject-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"3311842"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Smart

أرقام منخفضة التكلفة من دول كثيرة، مع رموز المناطق والأولوية وحتى 5 أرقام في الطلب الواحد.

عرض الخدمات والأسعار

يعرض خدمات Smart مع سعرك لكل منها، بعد الخصم.

GET/server5-pricing
المعلمةالنوعمطلوبالوصف
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl "https://textverification.io/api/v1/users/server5-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "7d0f3b11",
      "serviceName": "Telegram",
      "price": "0.12"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

عرض الدول

يعرض الدول التي يبيع فيها Smart أرقامًا، مع رموزها.

GET/server5-countries
مثال على الطلب
curl "https://textverification.io/api/v1/users/server5-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

الحصول على خيارات الطلب

يُعيد رموز المناطق المتاحة لخدمة في دولة ما، ومقدار ما تضيفه إلى السعر.

GET/server5-options
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl "https://textverification.io/api/v1/users/server5-options?serviceId=7d0f3b11&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "price": "0.12",
    "successRate": 61,
    "bestSuccess": {
      "price": "0.15",
      "successRate": 84
    },
    "areaCodes": {
      "surcharge": 20,
      "lines": [
        {
          "price": "0.17",
          "successRate": 84,
          "codes": [
            "212",
            "646"
          ]
        }
      ]
    }
  },
  "message": "Request Successful!",
  "success": true
}

طلب رقم

يطلب رقم Smart لخدمة ما ويخصم ثمنه من رصيدك.

POST/request-s5-service
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
areaCodesstring[]لارموز المناطق المطلوبة، أو التي تريد تجنّبها مع excludeAreaCodes: قائمة أو قيم مفصولة بفواصل، حتى 10. وهي تزيد السعر.
excludeAreaCodesbooleanلاtrue لتجنّب رموز المناطق بدلًا من الحصول على أحدها.
prioritystringلا"price" (الافتراضي) لأقل سعر، أو "success" للخط الأرجح لاستلام رمزك.
quantitynumberلاعدد الأرقام المطلوبة دفعة واحدة، من 1 إلى 5. ويصبح كل منها طلبًا مستقلًا.
phoneNumberstringلارقم محدد استخدمته من قبل، بالأرقام مع رمز الدولة، إن أصبح متاحًا مجددًا.

عند طلب كمية أكبر من 1، تعرض الاستجابة كل الطلبات المنفذة؛ وإذا تعذّر طلب العدد كاملًا، فإنها توضح العدد المنفذ والسبب.

مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"7d0f3b11","areaCodes":["212"],"priority":"success"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "status": "reserved",
    "price": "0.14",
    "expiredIn": 1200
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على طلب

يُعيد الطلب بحالته، والرمز بمجرد وصوله.

GET/number-details-s5
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/number-details-s5?orderId=AB12CD34" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.14",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

إعادة استخدام رقم

يطلب الرقم نفسه مجددًا لاستلام رمز آخر، إذا كانت الخدمة تسمح بذلك.

POST/reuse-s5-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reuse-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"AB12CD34"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.14",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء رقم

يلغي رقمًا لم يستلم رمزًا بعد ويعيد ثمنه إلى رصيدك.

POST/reject-s5-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reject-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"AB12CD34"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Plus

أرقام من دول كثيرة، ولكل خدمة عدة خطوط: اطلب الأرخص، أو اختر خطًا، أو حدّد أقصى ما تدفعه.

عرض الخدمات والأسعار

يعرض خدمات Plus مع سعرك لكل منها، بعد الخصم.

GET/server6-pricing
المعلمةالنوعمطلوبالوصف
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl "https://textverification.io/api/v1/users/server6-pricing?country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "5b2c9e41",
      "serviceName": "WhatsApp",
      "price": "0.68"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

عرض الدول

يعرض الدول التي يبيع فيها Plus أرقامًا، مع رموزها.

GET/server6-countries
مثال على الطلب
curl "https://textverification.io/api/v1/users/server6-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    },
    {
      "code": "gb",
      "name": "United Kingdom"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

عرض الخطوط والأسعار

يعرض الخطوط التي تُباع عبرها خدمة في دولة ما، بدءًا من الأرخص، مع سعرك لكل خط ونسبة نجاحه متى عُرفت.

GET/server6-options
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl "https://textverification.io/api/v1/users/server6-options?serviceId=5b2c9e41&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "price": "0.68",
    "lines": [
      {
        "lineId": "a91f03c2",
        "price": "0.68",
        "successRate": 92
      },
      {
        "lineId": "4e7d2b10",
        "price": "0.68",
        "successRate": null
      },
      {
        "lineId": "c03b5f77",
        "price": "1.08",
        "successRate": 97
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

طلب رقم

يطلب رقم Plus لخدمة ما ويخصم ثمنه من رصيدك.

POST/request-s6-service
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
lineIdstringلاخط من قائمة الخطوط. اتركه فارغًا لاستخدام الخط الأرخص.
maxPricenumberلاأقصى مبلغ ستدفعه بالدولار الأمريكي. يُرفض أي سعر أعلى منه؛ ومن دون lineId قد يُستخدم أي خط حتى هذا السعر.

من دون lineId يُستخدم الخط الأرخص، وخط آخر بالسعر نفسه إن لم تتوفر فيه أرقام. إذا لم يوصل خطٌّ الرموز لخدمة ما، فارفض الرقم واطلب من lineId آخر.

مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"5b2c9e41","country":"us","maxPrice":0.7}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "0.68",
    "expiredIn": 1200,
    "lineId": "a91f03c2"
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على طلب

يُعيد الطلب بحالته، والرمز بمجرد وصوله.

GET/number-details-s6
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/number-details-s6?orderId=230698" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "0.68",
    "lineId": "a91f03c2",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

إعادة استخدام رقم

يطلب الرقم نفسه مجددًا لاستلام رمز آخر، إذا كانت الخدمة تسمح بذلك.

POST/reuse-s6-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reuse-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"230698"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "0.68",
    "lineId": "a91f03c2",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء رقم

يلغي رقمًا لم يستلم رمزًا بعد ويعيد ثمنه إلى رصيدك.

POST/reject-s6-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reject-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"230698"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Express

أرقام أمريكية لرمز سريع: اطلب رقمًا لخدمة، ثم احصل على الرمز من تفاصيل الطلب أو عبر استدعاء عكسي خلال دقائق الرقم الخمس.

عرض الخدمات والأسعار

يعرض خدمات Express مع سعرك لكل منها، بعد الخصم.

GET/server7-pricing
مثال على الطلب
curl "https://textverification.io/api/v1/users/server7-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "3e7a91c0",
      "serviceName": "WhatsApp",
      "price": "0.75",
      "multiplePrice": "1.13",
      "smsModes": [
        "single",
        "multiple"
      ]
    },
    {
      "serviceId": "8b2c40d1",
      "serviceName": "Telegram",
      "price": "0.50",
      "multiplePrice": null,
      "smsModes": [
        "single"
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

طلب رقم

يطلب رقم Express لخدمة ما ويخصم ثمنه من رصيدك.

POST/request-s7-service
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
smsModestringلا"multiple" لاستلام كل رسالة تُرسل إلى الرقم ما دام نشطًا (5 دقائق)، وتُسلَّم كل منها فور وصولها، بسعر multiplePrice للخدمة. متاح فقط للخدمات التي تتضمن smsModes فيها "multiple". القيمة الافتراضية "single"، أو "multiple" للخدمة التي تُباع بهذه الطريقة فقط.

يبقى رقم Express نشطًا لمدة 5 دقائق. إذا لم يصل أي رمز خلال هذه المدة، يُلغى الطلب ويُسترد المبلغ تلقائيًا. لا يمكن إعادة استخدام أرقام Express. مع smsMode بقيمة "multiple" يستمر الرقم في استلام الرموز طوال دقائقه الخمس: كل رمز جديد يرسل إشعار s7_otp_received آخر، وتسرد تفاصيل الطلب كل الرموز، والأحدث في pin.

مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-s7-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"3e7a91c0","smsMode":"multiple"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "9f2c41ab07d3e815",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "1.13",
    "expiredIn": 300,
    "smsMode": "multiple"
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على طلب

يُعيد الطلب بحالته، والرمز بمجرد وصوله.

GET/number-details-s7
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/number-details-s7?orderId=9f2c41ab07d3e815" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "9f2c41ab07d3e815",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "1.13",
    "smsMode": "multiple",
    "codes": [
      {
        "code": "318204",
        "message": "Your code is 318204",
        "receivedAt": "2026-10-09 12:44:00"
      },
      {
        "code": "482910",
        "message": "Your code is 482910",
        "receivedAt": "2026-10-09 12:44:00"
      }
    ],
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء رقم

يلغي رقمًا لم يستلم رمزًا بعد ويعيد ثمنه إلى رصيدك.

POST/reject-s7-service
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/reject-s7-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9f2c41ab07d3e815"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

تأجير Pinpoint

احتفظ برقم أمريكي لخدمة واحدة من يوم إلى سنة، مع التجديد والتجديد التلقائي.

عرض خدمات الإيجار والأسعار

يعرض خدمات تأجير Pinpoint مع سعرك لكل مدة إيجار.

GET/rental-services
مثال على الطلب
curl "https://textverification.io/api/v1/users/rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "rg5e1d20",
      "serviceName": "whatsapp"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

تسعير إيجار

يُعيد سعرك لكل مدة إيجار لخدمة واحدة، مع رموز المناطق أو بدونها.

GET/rental-prices
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
areasstringلارموز المناطق، مفصولة بفواصل (حتى 10). وهي تزيد السعر.

لا تتوفر كل المدد لكل خدمة: تُعيد نقطة النهاية هذه المدد التي يمكن استئجار الخدمة لها.

مثال على الطلب
curl "https://textverification.io/api/v1/users/rental-prices?serviceId=rg5e1d20" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "label": "oneDay",
      "days": 1,
      "price": "2.85"
    },
    {
      "label": "thirtyDay",
      "days": 30,
      "price": "7.20"
    },
    {
      "label": "oneYear",
      "days": 365,
      "price": "72.00"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

استئجار رقم

يستأجر رقمًا عبر تأجير Pinpoint لخدمة ما ويخصم من رصيدك ثمن المدة كاملة.

POST/request-rental
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
durationstringنعممدة الإيجار: oneDay أو threeDay أو sevenDay أو fourteenDay أو thirtyDay أو ninetyDay أو oneYear.
areasstringلارموز المناطق، مفصولة بفواصل (حتى 10). وهي تزيد السعر.
autoRenewbooleanلاtrue لتجديد الإيجار من رصيدك قبل انتهائه ببضع ساعات.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"rg5e1d20","duration":"thirtyDay","autoRenew":true}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "7.20",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "thirtyDay",
    "duration": 30,
    "renewals": 0
  },
  "message": "Request Successful!",
  "success": true
}

قراءة رسائل الإيجار

يُعيد الرسائل التي استلمها الإيجار، الأحدث أولًا.

GET/rental-messages
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
page / limitnumberلارقم الصفحة، وحجم الصفحة (حتى 100).
مثال على الطلب
curl "https://textverification.io/api/v1/users/rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على أسعار التجديد

يعرض المدد التي يمكن تجديد إيجار جارٍ لها، مع سعرك لكل منها.

GET/rental-renew-options
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/rental-renew-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "whatsapp",
    "periods": [
      {
        "period": "thirtyDay",
        "days": 30,
        "price": "7.20"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

تجديد إيجار

يمدد إيجارًا جاريًا ويخصم من رصيدك. وإذا لم تحدد مدة، يُجدَّد لمدته الأصلية.

POST/renew-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
periodstringلامدة التجديد (القيم نفسها المستخدمة في duration). لا ترسلها للتجديد بمدة الإيجار الأصلية.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/renew-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"thirtyDay"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "14.40",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "thirtyDay",
    "duration": 30,
    "renewals": 1
  },
  "message": "Request Successful!",
  "success": true
}

تشغيل التجديد التلقائي أو إيقافه

يحدد ما إذا كان الإيجار الجاري يُجدَّد من رصيدك قبل انتهائه ببضع ساعات.

POST/rental-auto-renew
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
enabledbooleanنعمtrue لتشغيل التجديد التلقائي، وfalse لإيقافه.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":false}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": false
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء إيجار

يلغي إيجارًا لا يزال قابلًا للاسترداد (قبل أول رسالة) ويعيد ثمنه إلى رصيدك.

POST/release-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/release-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

تأجير Flex

احتفظ برقم أمريكي من يوم إلى 30 يومًا، مع التجديد التلقائي وإعادة تفعيل الأرقام المنتهية الصلاحية.

عرض خدمات الإيجار والأسعار

يعرض خدمات تأجير Flex مع سعرك لكل مدة إيجار.

GET/s3-rental-services
المعلمةالنوعمطلوبالوصف
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl "https://textverification.io/api/v1/users/s3-rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "1f3aa214",
      "serviceName": "Amazon",
      "prices": [
        {
          "period": "1d",
          "days": 1,
          "price": "2.88"
        },
        {
          "period": "30d",
          "days": 30,
          "price": "5.76"
        }
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

عرض الدول

يعرض الدول التي يبيع فيها تأجير Flex أرقامًا، مع رموزها.

GET/s3-rental-countries
مثال على الطلب
curl "https://textverification.io/api/v1/users/s3-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

استئجار رقم

يستأجر رقمًا عبر تأجير Flex لخدمة ما ويخصم من رصيدك ثمن المدة كاملة.

POST/request-s3-rental
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
periodstringنعممدة الإيجار، من قائمة الخدمات، مثل "7d".
areasstringلارموز المناطق، مفصولة بفواصل (حتى 10). وهي تزيد السعر.
autoRenewbooleanلاtrue لتجديد الإيجار من رصيدك قبل انتهائه ببضع ساعات.
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1f3aa214","period":"7d","autoRenew":true}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.20",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7,
    "renewPrice": "3.20"
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على إيجار

يُعيد الإيجار بحالته وتاريخ انتهائه وإعدادات تجديده.

GET/s3-rental-details
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/s3-rental-details?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.20",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

قراءة رسائل الإيجار

يُعيد الرسائل التي استلمها الإيجار، الأحدث أولًا.

GET/s3-rental-messages
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
page / limitnumberلارقم الصفحة، وحجم الصفحة (حتى 100).
مثال على الطلب
curl "https://textverification.io/api/v1/users/s3-rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

تجديد إيجار

يمدد إيجارًا جاريًا ويخصم من رصيدك. وإذا لم تحدد مدة، يُجدَّد لمدته الأصلية.

POST/renew-s3-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/renew-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "6.40",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

تشغيل التجديد التلقائي أو إيقافه

يحدد ما إذا كان الإيجار الجاري يُجدَّد من رصيدك قبل انتهائه ببضع ساعات.

POST/s3-rental-auto-renew
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
enabledbooleanنعمtrue لتشغيل التجديد التلقائي، وfalse لإيقافه.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/s3-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":true}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء إيجار

يلغي إيجارًا لا يزال قابلًا للاسترداد (قبل أول رسالة) ويعيد ثمنه إلى رصيدك.

POST/cancel-s3-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/cancel-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

الحصول على أسعار إعادة التفعيل

يعرض المدد التي يمكن إعادة تفعيل رقم إيجار منتهٍ لها، مع سعرك لكل منها.

GET/s3-rental-retake-options
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/s3-rental-retake-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "Amazon",
    "periods": [
      {
        "period": "7d",
        "days": 7,
        "price": "4.80"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

إعادة تفعيل رقم منتهي الصلاحية

يستأجر رقم إيجار منتهٍ مجددًا للخدمة نفسها، ما دام لا يزال متاحًا.

POST/retake-s3-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
periodstringنعممدة الإيجار، من قائمة الخدمات، مثل "7d".
autoRenewbooleanلاtrue لتجديد الإيجار من رصيدك قبل انتهائه ببضع ساعات.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/retake-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"7d"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f9a811",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "4.80",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

تأجير Global

استأجر أرقامًا في دول كثيرة، وجدّدها لأي مدة متاحة، أو دعها تتجدد تلقائيًا.

عرض خدمات الإيجار والأسعار

يعرض خدمات تأجير Global مع سعرك لكل مدة إيجار.

GET/s4-rental-services
المعلمةالنوعمطلوبالوصف
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl "https://textverification.io/api/v1/users/s4-rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "c41e7a02",
      "serviceName": "WhatsApp",
      "prices": [
        {
          "period": "1d",
          "days": 1,
          "price": "0.90"
        },
        {
          "period": "30d",
          "days": 30,
          "price": "9.60"
        }
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

عرض الدول

يعرض الدول التي يبيع فيها تأجير Global أرقامًا، مع رموزها.

GET/s4-rental-countries
مثال على الطلب
curl "https://textverification.io/api/v1/users/s4-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

استئجار رقم

يستأجر رقمًا عبر تأجير Global لخدمة ما ويخصم من رصيدك ثمن المدة كاملة.

POST/request-s4-rental
المعلمةالنوعمطلوبالوصف
serviceIdstringنعممعرّف الخدمة، من قائمة الخدمات.
periodstringنعممدة الإيجار، من قائمة الخدمات، مثل "7d".
autoRenewbooleanلاtrue لتجديد الإيجار من رصيدك قبل انتهائه ببضع ساعات.
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"c41e7a02","period":"30d","country":"us"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على إيجار

يُعيد الإيجار بحالته وتاريخ انتهائه وإعدادات تجديده.

GET/s4-rental-details
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/s4-rental-details?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

قراءة رسائل الإيجار

يُعيد الرسائل التي استلمها الإيجار، الأحدث أولًا.

GET/s4-rental-messages
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
page / limitnumberلارقم الصفحة، وحجم الصفحة (حتى 100).
مثال على الطلب
curl "https://textverification.io/api/v1/users/s4-rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على أسعار التجديد

يعرض المدد التي يمكن تجديد إيجار جارٍ لها، مع سعرك لكل منها.

GET/s4-rental-renew-options
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/s4-rental-renew-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "periods": [
      {
        "period": "30d",
        "days": 30,
        "price": "9.60"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

تجديد إيجار

يمدد إيجارًا جاريًا ويخصم من رصيدك. وإذا لم تحدد مدة، يُجدَّد لمدته الأصلية.

POST/renew-s4-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
periodstringلامدة التجديد، من أسعار التجديد. لا ترسلها للتجديد بمدة الإيجار الأصلية.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/renew-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"30d"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "19.20",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

تشغيل التجديد التلقائي أو إيقافه

يحدد ما إذا كان الإيجار الجاري يُجدَّد من رصيدك قبل انتهائه ببضع ساعات.

POST/s4-rental-auto-renew
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
enabledbooleanنعمtrue لتشغيل التجديد التلقائي، وfalse لإيقافه.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/s4-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":true}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء إيجار

يلغي إيجارًا لا يزال قابلًا للاسترداد (قبل أول رسالة) ويعيد ثمنه إلى رصيدك.

POST/cancel-s4-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/cancel-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

الحصول على أسعار إعادة التفعيل

يعرض المدد التي يمكن إعادة تفعيل رقم إيجار منتهٍ لها، مع سعرك لكل منها.

GET/s4-rental-retake-options
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/s4-rental-retake-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "periods": [
      {
        "period": "30d",
        "days": 30,
        "price": "9.60"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

إعادة تفعيل رقم منتهي الصلاحية

يستأجر رقم إيجار منتهٍ مجددًا للخدمة نفسها، ما دام لا يزال متاحًا.

POST/retake-s4-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
periodstringنعممدة الإيجار، من قائمة الخدمات، مثل "7d".
autoRenewbooleanلاtrue لتجديد الإيجار من رصيدك قبل انتهائه ببضع ساعات.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/retake-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"30d"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f9a811",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

تأجير Plus

استأجر رقم دولة بالشهر ليستقبل رسائل كل الخدمات، وجدّده أو اتركه يتجدد تلقائيًا.

عرض الدول

يعرض الدول التي يبيع فيها تأجير Plus أرقامًا، مع رموزها.

GET/s6-rental-countries
مثال على الطلب
curl "https://textverification.io/api/v1/users/s6-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": [
    {
      "code": "ca",
      "name": "Canada"
    },
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

عرض مدد الإيجار والأسعار

يعرض المدد التي تُستأجر بها أرقام تأجير Plus في دولة ما، مع سعرك لكل مدة.

GET/s6-rental-plans
المعلمةالنوعمطلوبالوصف
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).
مثال على الطلب
curl "https://textverification.io/api/v1/users/s6-rental-plans?country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "country": {
      "code": "us",
      "name": "United States"
    },
    "plans": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      },
      {
        "period": "3m",
        "months": 3,
        "days": 90,
        "price": "21.00"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

استئجار رقم

يستأجر رقمًا عبر تأجير Plus لخدمة ما ويخصم من رصيدك ثمن المدة كاملة.

POST/request-s6-rental
المعلمةالنوعمطلوبالوصف
periodstringنعممدة الإيجار بالأشهر من قائمة المدد: "1m" أو "2m" أو "3m" أو "6m" أو "12m".
autoRenewbooleanلاtrue لتجديد الإيجار من رصيدك قبل انتهائه ببضع ساعات.
countrystringلارمز دولة من قائمة الدول. لا ترسله للولايات المتحدة (أو لأول دولة معروضة للبيع).

رقم تأجير Plus غير مرتبط بخدمة واحدة: فهو يستقبل رسائل كل الخدمات. ويمكن إلغاؤه مع استرداد المبلغ خلال 20 دقيقة من الاستئجار، قبل أول رسالة.

مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/request-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"1m","country":"us","autoRenew":true}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "7.50",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على إيجار

يُعيد الإيجار بحالته وتاريخ انتهائه وإعدادات تجديده.

GET/s6-rental-details
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/s6-rental-details?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "7.50",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

قراءة رسائل الإيجار

يُعيد الرسائل التي استلمها الإيجار، الأحدث أولًا.

GET/s6-rental-messages
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
page / limitnumberلارقم الصفحة، وحجم الصفحة (حتى 100).
مثال على الطلب
curl "https://textverification.io/api/v1/users/s6-rental-messages?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "9c41e2b7",
        "number": "15143080170",
        "service": "Any service",
        "sender": "",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

الحصول على أسعار التجديد

يعرض المدد التي يمكن تجديد إيجار جارٍ لها، مع سعرك لكل منها.

GET/s6-rental-renew-options
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/s6-rental-renew-options?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "periods": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      },
      {
        "period": "3m",
        "months": 3,
        "days": 90,
        "price": "21.00"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

تجديد إيجار

يمدد إيجارًا جاريًا ويخصم من رصيدك. وإذا لم تحدد مدة، يُجدَّد لمدته الأصلية.

POST/renew-s6-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
periodstringلاالمدة التي تريد التجديد لها من أسعار التجديد، مثل "1m". اتركها فارغة للتجديد بمدة الإيجار نفسها.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/renew-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","period":"3m"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "28.50",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2027-02-09 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

تشغيل التجديد التلقائي أو إيقافه

يحدد ما إذا كان الإيجار الجاري يُجدَّد من رصيدك قبل انتهائه ببضع ساعات.

POST/s6-rental-auto-renew
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
enabledbooleanنعمtrue لتشغيل التجديد التلقائي، وfalse لإيقافه.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/s6-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","enabled":true}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

إلغاء إيجار

يلغي إيجارًا لا يزال قابلًا للاسترداد (قبل أول رسالة) ويعيد ثمنه إلى رصيدك.

POST/cancel-s6-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/cancel-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

الحصول على أسعار إعادة التفعيل

يعرض المدد التي يمكن إعادة تفعيل رقم إيجار منتهٍ لها، مع سعرك لكل منها.

GET/s6-rental-retake-options
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
مثال على الطلب
curl "https://textverification.io/api/v1/users/s6-rental-retake-options?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "periods": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

إعادة تفعيل رقم منتهي الصلاحية

يستأجر رقم إيجار منتهٍ مجددًا للخدمة نفسها، ما دام لا يزال متاحًا.

POST/retake-s6-rental
المعلمةالنوعمطلوبالوصف
orderIdstringنعممعرّف الطلب، كما أُعيد عند الطلب.
periodstringنعممدة الإيجار بالأشهر من قائمة المدد: "1m" أو "2m" أو "3m" أو "6m" أو "12m".
autoRenewbooleanلاtrue لتجديد الإيجار من رصيدك قبل انتهائه ببضع ساعات.

إعادة التفعيل تجدد الإيجار نفسه، مع الاحتفاظ بـ orderId والرقم. وهي متاحة لبضعة أيام بعد انتهاء الإيجار.

مثال على الطلب
curl -X POST "https://textverification.io/api/v1/users/retake-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","period":"1m"}'
مثال على الاستجابة
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "15.00",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

الاستدعاء العكسي

اضبط عنوان URL للاستدعاء العكسي في إعدادات حسابك. في كل مرة يصل فيها رمز أو رسالة إيجار، نرسلها إلى ذلك العنوان في طلب HTTP POST يتضمن متنه بصيغة JSON الحقلين event وdata.

  • أجب بحالة 2xx خلال 5 ثوانٍ لتأكيد الاستلام.
  • إذا لم يُجب خادمك في الوقت المحدد أو أعاد حالة أخرى، نعيد المحاولة بعد ثانيتين، ثم بعد 4 ثوانٍ: 3 محاولات إجمالًا.
  • قد يصل الحدث نفسه أكثر من مرة: استخدم orderId لتجاهل التكرارات.

الأحداث

الحدثيُرسل عندما
s1_otp_receivedيستلم رقم Prime رمزه.
s1_win_premium_requestيفوز طلب مميز في Prime برقم.
s2_otp_receivedيستلم رقم Pinpoint رمزه.
s3_otp_receivedيستلم رقم Flex رمزه.
s4_otp_receivedيستلم رقم Global رمزه.
s5_otp_receivedيستلم رقم Smart رمزه.
s6_otp_receivedيستلم رقم Plus رمزه.
s7_otp_receivedيستلم رقم Express رمزه.
rental_otp_receivedتصل رسالة إلى رقم مستأجر عبر تأجير Pinpoint.
s3_rental_otp_receivedتصل رسالة إلى رقم مستأجر عبر تأجير Flex.
s4_rental_otp_receivedتصل رسالة إلى رقم مستأجر عبر تأجير Global.
s6_rental_otp_receivedتصل رسالة إلى رقم مستأجر عبر تأجير Plus.

الحمولة

data.orderId
الطلب الذي ينتمي إليه الرمز.
data.timestamp
وقت استلامنا له (UTC).
data.number
رقم الهاتف الذي استلمه.
data.service
الخدمة التي طُلب الرقم لها.
data.message
الرسالة كاملة.
data.otp
الرمز المستخرج من الرسالة.
مثال على الاستدعاء العكسي
{
  "event": "s2_otp_received",
  "data": {
    "orderId": "lr_01K7ABC",
    "timestamp": "2026-10-09 12:44:00",
    "number": "12125550102",
    "service": "google",
    "message": "G-482910 is your Google verification code.",
    "otp": "482910"
  }
}

تواجه مشكلة في التكامل؟ تواصل مع فريقنا.