📡 SMS Numbers API

يعيد رصيد حسابك الحالي. Returns your current account balance.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/balance

{
  "ok": true,
  "balance": "125.50",
  "currency": "USD"
}

إحصائيات استخدام حسابك للـ API: عدد وقيمة الطلبات (الإجمالي وآخر 24 ساعة)، وعدد الطلبات والأخطاء اليوم (اليوم بتوقيت UTC). الخطأ هو أي رد حالته 400 أو أكثر. الأوردرات المحسوبة هي التي تمت عبر الـ API فقط. Usage statistics for your API account: number and value of orders (all-time and last 24 hours), plus today's request and error counts (day = UTC). An error is any response with status 400 or higher. Only orders placed through the API are counted.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/usage

{
  "balance": "113.00",
  "currency": "USD",
  "apiOrdersTotal": 47,
  "apiSpendTotal": "582.30",
  "apiOrders24h": 5,
  "apiSpend24h": "62.50",
  "requestCountToday": 128,
  "errorCountToday": 3
}

فحص صحة الخدمة. يعيد 200 عندما يعمل الـ API، و503 عندما يكون متوقفًا للصيانة. Service health check. Returns 200 when the API is running and 503 when it is stopped for maintenance.

curl http://fi16.bot-hosting.cloud:25538/v1/health

{ "ok": true, "service": "partner-api", "version": 1 }

{ "ok": false, "service": "partner-api", "version": 1, "error": "maintenance" }

يعيد قائمة الدول المتاحة للشراء حاليًا مع أسعارها. Returns the countries currently available for purchase, with their prices.

curl http://fi16.bot-hosting.cloud:25538/v1/countries

[
  {
    "country_code": "US",
    "country_name": "United States",
    "flag": "🇺🇸",
    "price": "1.50"
  }
]

يعيد سجل طلباتك (أرقام ومنتجات) من الأحدث إلى الأقدم، بترقيم صفحات. المعامل limit إجباري (من 1 إلى 200)، وإن أُرسل الطلب بدونه يُرجِع الخطأ LIMIT_REQUIRED (HTTP 400). المعامل offset اختياري (الافتراضي 0) لجلب الصفحات التالية، مثال: ?limit=50&offset=50 للصفحة الثانية. الإجمالي في الترويسة X-Total-Count، و X-Has-More: true إن وُجدت صفحة تالية. إذا سبق جلب كود الرقم فإنه يظهر في الحقل code ومعه password إن وُجدت. Returns your order history (numbers and products), newest first, paginated. The limit parameter is required (1 to 200); a request without it gets LIMIT_REQUIRED (HTTP 400). offset is optional (default 0) for the next pages, e.g. ?limit=50&offset=50 for page two. The total is in the X-Total-Count header, and X-Has-More: true means another page exists. If the number's code was already fetched, it appears in code with password if present.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "http://fi16.bot-hosting.cloud:25538/v1/orders?limit=50"

[
  {
    "id": 118,
    "type": "number",
    "title": "United States",
    "title_en": "United States",
    "price": "1.50",
    "discount": "0.00",
    "status": "completed",
    "created_at": "2026-09-19T10:15:00+00:00",
    "phone": "+1555...",
    "code": "482913",
    "password": null
  }
]

يشتري رقم تفعيل لدولة محددة، ويُخصم السعر من رصيدك فورًا. إذا فشلت العملية قبل التنفيذ أو رُفضت بوضوح، يُعاد الرصيد تلقائيًا. أما إذا لم تتأكد النتيجة (انتهاء مهلة أو خطأ في المعالجة)، فلا يُعاد الرصيد تلقائيًا: يُراجَع الطلب يدويًا (الرمز ORDER_UNDER_REVIEW). Buys an activation number for a given country. The price is deducted immediately. If the purchase fails before execution, or is clearly rejected, your balance is refunded automatically. If the result is unknown (timeout or a processing error), the balance is not refunded automatically: the order goes to manual review (ORDER_UNDER_REVIEW).

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"country_code": "US", "external_order_id": "shop-order-1001"}' \
  http://fi16.bot-hosting.cloud:25538/v1/numbers/buy

{
  "order_id": 118,
  "order_type": "number",
  "country_code": "US",
  "phone": "+1555xxxxxxx",
  "price": "1.50",
  "status": "pending",
  "external_order_id": "shop-order-1001",
  "idempotent_replay": false
}

يجلب كود التفعيل لطلب معيّن. قيمة order_type إما number (الافتراضية) أو manual_number. إذا لم يصل الكود بعد فسيُعاد 404؛ أعد الطلب بعد بضع ثوانٍ. وبمجرد وصول الكود يُحفظ، فإذا استدعيت الطلب نفسه مرة أخرى أعاد الكود نفسه. ويكون password قيمته null إذا لم يكن للرقم كلمة مرور. Fetches the activation code for a specific order. order_type is either number or manual_number. If the code has not arrived yet you get 404; retry after a few seconds. Once the code arrives it is stored and repeated requests return the same code.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "http://fi16.bot-hosting.cloud:25538/v1/orders/118/code?order_type=number"

{
  "order_id": 118,
  "phone": "+1555xxxxxxx",
  "code": "482913",
  "password": null,
  "status": "completed"
}

يعيد سعر اشتراك تيليجرام مميز لكل مدة متاحة. Returns the price of Telegram Premium for every available duration.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/telegram/premium/prices

[
  { "duration_months": 3, "price": "15.00" },
  { "duration_months": 6, "price": "22.00" },
  { "duration_months": 12, "price": "38.00" }
]

يحسب سعر كمية معيّنة من نجوم تيليجرام قبل الشراء. Calculates the price of a given quantity of Telegram Stars before buying.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "http://fi16.bot-hosting.cloud:25538/v1/telegram/stars/price?quantity=100"

{ "quantity": 100, "price": "2.00" }

يشتري نجوم تيليجرام ويرسلها لليوزر المحدد. نفس آلية الخصم الذري وقاعدة الاسترجاع (تلقائي عند الرفض المؤكد فقط، ومراجعة يدوية عند عدم تأكد النتيجة) و external_order_id بتاعة /v1/numbers/buy. Buys Telegram Stars and sends them to the given username. Same atomic deduction, refund rule (automatic only on a clear rejection, manual review when the result is unknown) and external_order_id mechanics as /v1/numbers/buy.

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_username": "someuser", "quantity": 100, "external_order_id": "shop-stars-1"}' \
  http://fi16.bot-hosting.cloud:25538/v1/telegram/stars/buy

{
  "order_id": 45,
  "order_type": "stars",
  "target_username": "someuser",
  "quantity": 100,
  "duration_months": null,
  "price": "2.00",
  "status": "processing",
  "external_order_id": "shop-stars-1",
  "idempotent_replay": false
}

يشتري اشتراك تيليجرام مميز لليوزر المحدد. نفس آلية /v1/numbers/buy تمامًا. Buys a Telegram Premium subscription for the given username. Same mechanics as /v1/numbers/buy.

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_username": "someuser", "duration_months": 3, "external_order_id": "shop-prem-1"}' \
  http://fi16.bot-hosting.cloud:25538/v1/telegram/premium/buy

{
  "order_id": 46,
  "order_type": "premium",
  "target_username": "someuser",
  "quantity": null,
  "duration_months": 3,
  "price": "15.00",
  "status": "processing",
  "external_order_id": "shop-prem-1",
  "idempotent_replay": false
}

يعيد حالة طلب نجوم/بريميوم. إن لم تكن الحالة نهائية بعد، يحاول تحديثها مباشرةً. الحالات: processing، completed، failed، under_review (تحت المراجعة اليدوية؛ الرصيد لم يُعَد بعد)، refunded (أُعيد الرصيد بعد المراجعة). Returns the status of a Stars/Premium order. If the status is not final yet, it tries to refresh it live. Statuses: processing, completed, failed, under_review (manual review; balance not refunded yet), refunded (balance returned after review).

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/telegram/orders/45

{
  "order_id": 45,
  "order_type": "stars",
  "target_username": "someuser",
  "quantity": 100,
  "duration_months": null,
  "price": "2.00",
  "status": "completed",
  "external_order_id": "shop-stars-1",
  "idempotent_replay": false
}

يعيد المنتجات المتاحة للشراء مجمّعة حسب التصنيف (المفعّل فقط). المنتج الذي نفد مخزونه يبقى ظاهرًا ويأتي بـ in_stock: false. الكمية الفعلية stock تظهر فقط للمنتجات التي فعّل لها المسؤول إظهار الكمية، وإلا تكون null. معامل اختياري: category_id لعرض تصنيف واحد. التصنيفات قد تكون متداخلة: الحقل parent_id يكون null للتصنيف الرئيسي، ورقم التصنيف الأب للتصنيف الفرعي. التصنيف الفرعي تحت أب معطّل لا يظهر، والأب الذي يحتوي فرعيات فقط يظهر بقائمة products فارغة ليسهل بناء الشجرة. Returns the products you can buy, grouped by (active) category. Categories can be nested: parent_id is null for a top-level category, or the parent category's id for a subcategory. A subcategory under a disabled parent is hidden, and a parent that only contains subcategories is listed with an empty products array so you can rebuild the tree. A sold-out product stays listed with in_stock: false. The real quantity stock is only shown for products whose admin enabled quantity display; otherwise it is null. Optional parameter: category_id to show a single category.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "http://fi16.bot-hosting.cloud:25538/v1/products"

[
  {
    "id": 3,
    "parent_id": null,
    "name": "حسابات جيميل",
    "name_en": "Gmail accounts",
    "description": null,
    "description_en": null,
    "products": [
      {
        "id": 12,
        "name": "Gmail 2019",
        "name_en": "Gmail 2019",
        "description": "حساب جيميل قديم",
        "description_en": "Old Gmail account",
        "price": "1.50",
        "delivery_type": "account",
        "in_stock": true,
        "stock": null
      },
      {
        "id": 14,
        "name": "كود تفعيل",
        "name_en": "Activation code",
        "description": null,
        "description_en": null,
        "price": "0.80",
        "delivery_type": "code",
        "in_stock": false,
        "stock": null
      }
    ]
  }
]

يشتري منتجًا ويسلّمه فورًا في نفس الرد داخل الحقل delivery. المعاملات: product_id (إجباري، من GET /v1/products) و external_order_id (اختياري لكن يُنصح به بشدة). إعادة نفس الطلب بنفس external_order_id تُرجِع نفس الطلب ونفس البيانات من غير خصم ثانٍ (idempotent_replay: true)، فإذا انقطع الاتصال قبل وصول الرد فأعد الطلب بأمان. Buys a product and delivers it right away in the same response, inside delivery. Parameters: product_id (required, from GET /v1/products) and external_order_id (optional but strongly recommended). Repeating the request with the same external_order_id returns the same order and data without a second charge (idempotent_replay: true), so if the connection drops before the response arrives you can safely retry.

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"product_id": 12, "external_order_id": "shop-prod-1"}' \
  http://fi16.bot-hosting.cloud:25538/v1/products/buy

{
  "order_id": 88,
  "order_code": "ORD-7K2M9X4QA",
  "product_id": 12,
  "product_name": "Gmail 2019",
  "product_name_en": "Gmail 2019",
  "category_name": "حسابات جيميل",
  "category_name_en": "Gmail accounts",
  "price": "1.50",
  "status": "completed",
  "delivery": {
    "type": "account",
    "content": "user@example.com:S3cretPass",
    "email": "user@example.com",
    "password": "S3cretPass"
  },
  "external_order_id": "shop-prod-1",
  "idempotent_replay": false,
  "created_at": "2026-10-04T00:55:00+00:00"
}

يعيد بيانات طلب منتج اشتريته سابقًا (نفس حقل delivery الذي وصلك عند الشراء). لا يعمل إلا مع طلباتك أنت؛ غير ذلك يُرجِع ORDER_NOT_FOUND (404). Returns a product order you bought earlier (the same delivery field you got at purchase time). It only works for your own orders; otherwise it returns ORDER_NOT_FOUND (404).

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/products/orders/88

يجلب حالة أي طلب (أرقام / نجوم / بريميوم / منتجات / جلسات / خدمات) عبر external_order_id الذي أرسلته عند الشراء، دون الحاجة إلى order_id. مفيد جدًا بعد ORDER_UNDER_REVIEW أو انقطاع الاتصال. الحقل state هو حالة الطلب إن وُجد، وإلا حالة العملية (under_review / processing / refunded / done). إن لم يوجد شيء يعيد ORDER_NOT_FOUND (404). Looks up any order (numbers / Stars / Premium / products / sessions / services) by the external_order_id you sent at purchase time, without needing the order_id. Very useful after ORDER_UNDER_REVIEW or a dropped connection. state is the order status when an order exists, otherwise the operation state (under_review / processing / refunded / done). If nothing exists it returns ORDER_NOT_FOUND (404).

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/orders/by-external/shop-1042

{
  "external_order_id": "shop-1042",
  "state": "under_review",
  "order": null,
  "pending_op_id": 57
}

الدول المتاحة لشراء حزم الجلسات مع سعر الجلسة الواحدة والكمية المتاحة. Countries available for session packages, with the price per session and the available quantity.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/sessions/countries

[
  { "country_code": "US", "country_name": "United States", "flag": "🇺🇸", "price": "0.45", "available": 320 }
]

يشتري حزمة جلسات (من 1 إلى 1000). الرد status: processing حتى تُجهَّز الحزمة؛ تابع الحالة من GET /v1/sessions/orders/{order_id} ثم حمّل الملف. Buys a sessions package (1 to 1000). The response has status: processing until the package is prepared; poll GET /v1/sessions/orders/{order_id} and then download the file.

curl -H "Authorization: Bearer YOUR_TOKEN" -X POST -H "Content-Type: application/json" \
  -d '{"country_code":"US","quantity":5,"external_order_id":"shop-2001"}' \
  http://fi16.bot-hosting.cloud:25538/v1/sessions/buy

{
  "order_id": 31,
  "order_type": "session",
  "country_code": "US",
  "quantity": 5,
  "unit_price": "0.45",
  "price": "2.25",
  "status": "processing",
  "progress_percent": null,
  "completed_count": null,
  "download_ready": false,
  "external_order_id": "shop-2001",
  "idempotent_replay": false
}

حالة طلب الجلسات مع نسبة التقدم. عندما يصبح status: done وdownload_ready: true يمكنك التحميل. Sessions order status with progress. When status: done and download_ready: true you can download.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/sessions/orders/31

يحمّل حزمة الجلسات كملف zip بعد اكتمال الطلب. قبل الاكتمال يعيد ORDER_NOT_READY (409). Downloads the sessions package as a zip file once the order is done. Before that it returns ORDER_NOT_READY (409).

curl -H "Authorization: Bearer YOUR_TOKEN" -o sessions.zip \
  http://fi16.bot-hosting.cloud:25538/v1/sessions/orders/31/download

خدمات الـ SMM المتاحة مجمّعة حسب التصنيف، مع السعر لكل 1000 وحدود الكمية. الأسماء بالعربية name والإنجليزية name_en. الحقل parent_id يكون null للتصنيف الرئيسي، وإلا رقم التصنيف الأب. Available SMM services grouped by category, with the price per 1000 and the quantity limits. Names are in Arabic name and English name_en. parent_id is null for a top-level category, otherwise the parent category's id.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/services

[
  {
    "id": 4,
    "parent_id": null,
    "name": "متابعين",
    "name_en": "Followers",
    "services": [
      { "id": 21, "name": "متابعين انستجرام", "name_en": "Instagram followers",
        "price_per_1000": "1.80", "min_quantity": 100, "max_quantity": 10000 }
    ]
  }
]

يطلب خدمة SMM. السعر = السعر لكل 1000 × الكمية ÷ 1000. حالة الطلب تتحدث تلقائيًا؛ تابعها من GET /v1/services/orders/{order_id}. Orders an SMM service. Price = price per 1000 × quantity ÷ 1000. The order status updates automatically; follow it with GET /v1/services/orders/{order_id}.

curl -H "Authorization: Bearer YOUR_TOKEN" -X POST -H "Content-Type: application/json" \
  -d '{"service_id":21,"link":"https://instagram.com/yourpage","quantity":500,"external_order_id":"shop-3001"}' \
  http://fi16.bot-hosting.cloud:25538/v1/services/buy

{
  "order_id": 12,
  "order_code": "SMM-4H2K9QZ1",
  "order_type": "service",
  "service_id": 21,
  "service_name": "متابعين انستجرام",
  "service_name_en": "Instagram followers",
  "link": "https://instagram.com/yourpage",
  "quantity": 500,
  "price": "0.90",
  "status": "pending",
  "external_order_id": "shop-3001",
  "idempotent_replay": false
}

حالة طلب خدمة SMM اشتريتها. Status of an SMM service order you bought.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/services/orders/12

كشف حركات رصيدك من الأحدث للأقدم (شحن deposit / مشتريات purchase / استرجاع refund / تسويات adjustment) مع الرصيد قبل وبعد كل حركة. المبالغ نصوص، والسالب = خصم. الإجمالي في X-Total-Count وX-Has-More. الحقل request_id يربط الحركة بالطلب الذي سبّبها. الحركات القديمة (قبل الإصدار 1.5) قد تكون ناقصة. Your balance statement, newest first (deposit / purchase / refund / adjustment) with the balance before and after each entry. Amounts are strings; negative = debit. Total in X-Total-Count and X-Has-More. request_id links an entry to the request that caused it. Older entries (before v1.5) may be incomplete.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "http://fi16.bot-hosting.cloud:25538/v1/transactions?limit=50"

[
  { "id": 905, "type": "purchase", "amount": "-1.50", "balance_before": "10.00",
    "balance_after": "8.50", "request_id": "req_9de799b93459485f", "created_at": "2026-10-07T10:15:00+00:00" },
  { "id": 904, "type": "deposit", "amount": "10.00", "balance_before": "0.00",
    "balance_after": "10.00", "request_id": null, "created_at": "2026-10-07T09:50:00+00:00" }
]

شبكات USDT المتاحة للشحن وعنوان المحفظة لكل شبكة، مع معدل التحويل إلى رصيد. Available USDT networks for top-up, the wallet address for each, and the credit rate.

curl -H "Authorization: Bearer YOUR_TOKEN" \
  http://fi16.bot-hosting.cloud:25538/v1/deposit/networks

[
  { "network": "trc20", "label": "USDT · TRC20 (Tron)", "currency": "USDT",
    "address": "T...", "credit_rate": "1.00" }
]

الخطوة الأولى في الشحن. أرسل الشبكة والمبلغ المطلوب (لحد رقمين عشريين)، فيعيد لك مبلغًا دقيقًا فريدًا (مثل 10.0089) وعنوان المحفظة. حوّل هذا المبلغ بالضبط بنفس الأرقام العشرية قبل expires_at، ثم استدعِ /v1/deposit/verify. هذا المبلغ هو ما يربط التحويل بحسابك، فلا يستطيع أحد غيرك استخدام تحويلك. الحد الأقصى 3 طلبات نشطة لكل شبكة. الأخطاء: INVALID_AMOUNT وAMOUNT_OUT_OF_RANGE (422)، TOO_MANY_PENDING_REQUESTS (429)، AMOUNT_BUSY (503). Step 1 of a deposit. Send the network and the amount you want (up to 2 decimals) and you get back a unique exact amount (e.g. 10.0089) and the wallet address. Send exactly that amount, with the same decimals, before expires_at, then call /v1/deposit/verify. This amount is what ties the transfer to your account, so nobody else can claim your transaction. At most 3 active requests per network. Errors: INVALID_AMOUNT and AMOUNT_OUT_OF_RANGE (422), TOO_MANY_PENDING_REQUESTS (429), AMOUNT_BUSY (503).

curl -H "Authorization: Bearer YOUR_TOKEN" -X POST -H "Content-Type: application/json" \
  -d '{"network":"trc20","amount":"10"}' \
  http://fi16.bot-hosting.cloud:25538/v1/deposit/request

{
  "request_id": 41,
  "network": "trc20",
  "address": "T...",
  "amount_usdt": "10.0089",
  "expires_at": 1760000000,
  "expires_in": 3600
}

بعد أن تحوّل USDT إلى العنوان، أرسل الـ txid ليتحقق السيرفر من الشبكة ويضيف الرصيد (مع بونص الشحن إن وُجد). الـ txid هو مفتاح الـ idempotency: إعادته من نفس الحساب تعيد نفس النتيجة (idempotent_replay: true) دون شحن مرتين، واستخدامه من حساب آخر يعيد TXID_ALREADY_USED (409). يجب استدعاء /v1/deposit/request أولًا وتحويل المبلغ الدقيق الذي يعيده، وإلا يُرفض التحقق: NO_DEPOSIT_REQUEST وAMOUNT_MISMATCH وTX_BEFORE_REQUEST وREQUEST_EXPIRED (422). الأخطاء الأخرى: TX_NOT_VERIFIED (422) وVERIFICATION_UNAVAILABLE (503). كذلك DEPOSIT_REQUEST_ALREADY_USED (409): طلب الشحن استُهلك قبل كده، أنشئ طلبًا جديدًا. وCREDIT_FAILED (503): تم التحقق من التحويل لكن إضافة الرصيد فشلت، لا تحوّل مرة أخرى وتواصل مع الدعم برقم العملية (txid). After sending USDT to the address, submit the txid so the server verifies it on-chain and credits your balance (plus the top-up bonus when applicable). The txid is the idempotency key: repeating it from the same account returns the same result (idempotent_replay: true) without crediting twice, and using it from another account returns TXID_ALREADY_USED (409). You must call /v1/deposit/request first and send the exact amount it returns, otherwise verification is rejected: NO_DEPOSIT_REQUEST, AMOUNT_MISMATCH, TX_BEFORE_REQUEST and REQUEST_EXPIRED (422). Other errors: TX_NOT_VERIFIED (422) and VERIFICATION_UNAVAILABLE (503). Also DEPOSIT_REQUEST_ALREADY_USED (409): the deposit request was already used, create a new one. And CREDIT_FAILED (503): the transfer was verified but crediting failed, do not transfer again and contact support with the txid.

curl -H "Authorization: Bearer YOUR_TOKEN" -X POST -H "Content-Type: application/json" \
  -d '{"network":"trc20","txid":"<TRANSACTION_HASH>"}' \
  http://fi16.bot-hosting.cloud:25538/v1/deposit/verify

{
  "txid": "<TRANSACTION_HASH>",
  "network": "trc20",
  "amount_usdt": "10.00",
  "credited": "10.00",
  "bonus": "0.50",
  "total_credited": "10.50",
  "balance": "18.50",
  "currency": "USD",
  "idempotent_replay": false
}