SMSOnline API Doc
  1. Customer 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
      • Get invoices
        GET
      • Get Coupons
        GET
    • 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 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. Customer API

Get Account Balance

Developing
GET
https://api-x.smsonline.cloud/v3/customers/{userId}/balance
Obtain account balance and additional user information.

Request

Path Params
userId
string 
required
Your User Id
Example:
{{userid}}
Query Params
apiKey
string 
required
Issued API key
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/customers/{{userid}}/balance?apiKey={{APIKey}}'

Responses

🟢200Success
application/json
Body
ok
boolean 
required
body
object 
required
userId
string 
required
stripeId
string 
required
cryptomusId
null 
required
balance
integer 
required
Your account balance
status
null 
required
lang
null 
required
referral
null 
required
totalCharges
string 
required
Cumulative top-up amount
couponCount
integer 
required
Number of coupons held
currentDiscountRate
string 
required
Current account discount rate
vipSupport
boolean 
required
Whether dedicated support is available on Telegram
vipTelegram
string 
required
Dedicated manager's Telegram ID (if enabled)
discountRates
array [array] 
required
Currently set discount rate thresholds
Example
{
    "ok": true,
    "body": {
        "userId": "userId",
        "stripeId": "stripeId",
        "cryptomusId": null,
        "balance": 500,
        "status": null,
        "lang": null,
        "referral": null,
        "totalCharges": "500",
        "couponCount": 1,
        "currentDiscountRate": "-20%",
        "vipSupport": false,
        "vipTelegram": "",
        "discountRates": [
            [
                8000,
                0.8,
                "-20%"
            ],
            [
                6000,
                0.85,
                "-15%"
            ],
            [
                4000,
                0.9,
                "-10%"
            ],
            [
                2000,
                0.95,
                "-5%"
            ],
            [
                0,
                1,
                "0%"
            ]
        ]
    }
}
Modified at 2025-05-30 14:02:15
Previous
Toggle favourite status
Next
Get invoices
Built with