SMSOnline API Doc
  1. Lookup
SMSOnline API Doc
  • Preparation
  • FAQ
  • V3
    • Customer API
      • Payments
        • Cryptocurrency via Cryptomus
          • Create new payment
          • Get direct wallet
          • Get transaction status
        • Credit Card via Pay4bit
          • Create new payment
      • Favourites
        • Get favourite services
        • Toggle favourite status
      • Get Account Balance
      • Get invoices
      • Get Coupons
    • Phones API
      • Lookup API
        • Get service list by country and carrier
        • Get service detail by country and carrier
      • Inventory API
        • Get inventory
      • Order API
        • Order a number
        • Get order data
        • Change order status
      • Get Popular list
      • Get all available countries/carriers
    • Statistics API
      • Get statistics
  • V2(Deprecated)
    • Warning: V2 API is deprecated
    • Account
      • Get Balance
      • Make a top-up with crypto
      • (Get direct wallet address) Make a top-up with crypto
    • Lookup
      • Get Available Countries
        GET
      • Get Available Services
        GET
      • Get Service Details
        GET
      • Get the country stats with success rates
        GET
    • Manage phone numbers
      • Purchase Number
      • Return Number
      • Request Another SMS
      • Get Status of A Single Number
      • Get Bulk Status of Numbers With Conditions
  1. Lookup

Get Service Details

GET
https://api.smsonline.cloud/cs/getServiceDetail
This API endpoint returns the current pricing and stock availability of phone numbers that match the given service and country query parameters.
Additionally, it provides supplementary information on the pricing status of phone numbers for the same service in other countries.

Request

Query Params
userId
string 
required
User Id linked to API key
Example:
{{userid}}
key
string 
required
API key
Example:
{{APIKey}}
service
string 
required
Service Code
Example:
wa
country
string 
required
Country Code
Example:
3
carrier
string 
optional
Carrier Name, provided at this endpoint
Example:
unicom

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://api.smsonline.cloud/cs/getServiceDetail?userId={{userid}}&key={{APIKey}}&service=wa&country=3&carrier=unicom'

Responses

🟢200Success
application/json
If the request is completed successfully, a 200 response code is returned.
Body
error
boolean 
required
If the request fails, the status will be true.
body
object 
required
data
object 
required
Example
{
    "error": false,
    "body": {
        "data": {
            "id": "wa",
            "name": "WhatsApp",
            "price": 0.89,
            "m": "23660f0790b87514b1f36cbf8f0f0d7c",
            "n": "ee8ff55a829a147b8ae77dab2a7dbcea",
            "quantity": 560,
            "discountRate": 0.8,
            "deliverability": 0,
            "countryList": [
                {
                    "country_id": 4,
                    "country_name": "Philippines",
                    "price": 1.39,
                    "m": "b97cafce22b2756dfd9b149589799868",
                    "n": "a7b8835c116e69e7235883fcfa7e982f"
                },
                {
                    "country_id": 6,
                    "country_name": "Indonesia",
                    "price": 1.89,
                    "m": "9419487c4debff00ca531530a320c7b7",
                    "n": "1924d0701cd6a2450e40b12cd7480c09"
                },
                {
                    "country_id": 7,
                    "country_name": "Malaysia",
                    "price": 2.22,
                    "m": "7672a165f5e6d4d5f38c93db5f1362a4",
                    "n": "ee86be0d3445895ec4f0fbcc53bdab06"
                },
                {
                    "country_id": 10,
                    "country_name": "Vietnam",
                    "price": 2.33,
                    "m": "a771b3a6d8a420c8547d86ce5d611da5",
                    "n": "56e3ff04d6888b4ce512bbc3a7a7044a"
                },
                {
                    "country_id": 34,
                    "country_name": "Estonia",
                    "price": 2.99,
                    "m": "1db3d42399d5300e54fe9f1a1cde0c94",
                    "n": "dd7e8e280e7f2234311d45badf087bc5"
                },
                {
                    "country_id": 22,
                    "country_name": "India",
                    "price": 3.7,
                    "m": "1ba179b206146657a9dfb1c9ee16996e",
                    "n": "db279c60afc5c484c0ace14b28f7ba75"
                },
                {
                    "country_id": 0,
                    "country_name": "Russia",
                    "price": 3.92,
                    "m": "e70d78730c374e04b1853dddbdc8864e",
                    "n": "0d8250886da4ddd526e778a729527cd5"
                },
                {
                    "country_id": 1,
                    "country_name": "Ukraine",
                    "price": 4.29,
                    "m": "926f7dce906f874e490c34ee7e331eb8",
                    "n": "75ed0410b5a5671d106def8e0dc0e622"
                },
                {
                    "country_id": 15,
                    "country_name": "Poland",
                    "price": 4.69,
                    "m": "0460f0244ae07eeffbedf27fe76d94a6",
                    "n": "3f3484620aecd634453225f3ce37e5b4"
                },
                {
                    "country_id": 13,
                    "country_name": "Israel",
                    "price": 4.73,
                    "m": "c873c53067b9cf63de2b1fa3d5774867",
                    "n": "e6d964b68e100f35ba61fc332d0d1ac3"
                },
                {
                    "country_id": 19,
                    "country_name": "Nigeria",
                    "price": 4.97,
                    "m": "0211f7df42e9d61087f85cf632fde35e",
                    "n": "b4a9b586f317a371ff6d34b7ccdb23c9"
                },
                {
                    "country_id": 73,
                    "country_name": "Brazil",
                    "price": 5.87,
                    "m": "84bd40aebf409596d53eaf5642883506",
                    "n": "ee44949bd70c8bcb4ed6c97192ac41cd"
                },
                {
                    "country_id": 56,
                    "country_name": "Spain",
                    "price": 6.97,
                    "m": "2800088b6bf822f50afafd1a02a24322",
                    "n": "2c79d7f14f0809941758a264e0031fec"
                },
                {
                    "country_id": 172,
                    "country_name": "Denmark",
                    "price": 8.93,
                    "m": "220ae42ccef9df4199b9729096fac098",
                    "n": "1331f60e687702a62d5010fdefc22fea"
                },
                {
                    "country_id": 48,
                    "country_name": "Netherlands",
                    "price": 9,
                    "m": "91663084c56169df26fdfb5fb28b0d2e",
                    "n": "f80a1e5d417e90d5c2ad4874a423ca61"
                },
                {
                    "country_id": 2,
                    "country_name": "Kazakhstan",
                    "price": 9.46,
                    "m": "5d05be1ba9c9d1a9f47d7e5b17bc43ce",
                    "n": "09158fd91d74dea2877fd1a5d566b5f1"
                },
                {
                    "country_id": 46,
                    "country_name": "Sweden",
                    "price": 9.46,
                    "m": "c09b850407b3565c90f9339b989d8d4c",
                    "n": "45b1f003a1b0057771367c3b1b0c694e"
                },
                {
                    "country_id": 54,
                    "country_name": "Mexico",
                    "price": 11.42,
                    "m": "f99c4acc525c8cb165cf5faf512e6c5e",
                    "n": "4bb6bf6060c2205636f0a18e680aebf1"
                },
                {
                    "country_id": 78,
                    "country_name": "France",
                    "price": 13.24,
                    "m": "ffa6b268d9067b3b3878f4bf4befd0d8",
                    "n": "2370a5c834485cd5095de9c4bafabe5f"
                },
                {
                    "country_id": 43,
                    "country_name": "Germany",
                    "price": 15.64,
                    "m": "f6677830aebbfff543afc9c837e8a325",
                    "n": "ba2f53e277619b1fb09ca3a19833e914"
                },
                {
                    "country_id": 86,
                    "country_name": "Italy",
                    "price": 23.65,
                    "m": "a24453b0cad0b6555c561a4292a358a2",
                    "n": "055b6044aa21064212a61b184ffc1d89"
                },
                {
                    "country_id": 175,
                    "country_name": "Australia",
                    "price": 24.6,
                    "m": "e4d5b9341672c32f95a07f4ee2d80622",
                    "n": "87b21dc7c510007c66f125ab344082bf"
                }
            ],
            "carrierList": [
                "any",
                "china_unicom",
                "chinamobile",
                "unicom"
            ]
        }
    }
}
🟠401Unauthorized
🟠403Forbidden
🔴500Server Error
Modified at 2025-02-26 19:57:57
Previous
Get Available Services
Next
Get the country stats with success rates
Built with