SMSOnline API Doc
  1. Lookup API
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
        • Get service detail by country and carrier
          GET
      • Inventory API
        • Get inventory
      • Order API
        • Order a number
        • Get order data
        • Change order status
      • Get Popular list
        GET
      • Get all available countries/carriers
        GET
    • 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 Available Services
      • Get Service Details
      • Get the country stats with success rates
    • 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 API

Get service list by country and carrier

Developing
GET
https://api-x.smsonline.cloud/v3/numbers/lookup/{userId}/{country}/{carrier}
Get a list of services available in a given country and carrier.
If the user has exceeded the discount rate threshold based on cumulative deposits, the price is displayed after the discount has been applied.

Request

Path Params
userId
string 
required
Example:
{{userid}}
country
string 
required
Example:
3
carrier
string 
required
Example:
Auto select
Query Params
apiKey
string 
required
Example:
{{APIKey}}

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-x.smsonline.cloud/v3/numbers/lookup/{{userid}}/3/Auto select?apiKey={{APIKey}}'

Responses

🟢200Success
application/json
Body
ok
boolean 
required
body
object 
required
data
array [object {9}] 
required
Example
{
    "ok": true,
    "body": {
        "data": [
            {
                "id": "qf",
                "name": "RedBook",
                "price": 1.6,
                "quantity": 90,
                "deliverability": 66.67,
                "discountRate": 0.8,
                "m": "_",
                "n": "_",
                "favourite": false
            }
        ]
    }
}
Modified at 2025-05-17 05:37:00
Previous
Get Coupons
Next
Get service detail by country and carrier
Built with