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 Coupons

Developing
GET
https://api-x.smsonline.cloud/v3/customers/{userId}/coupons
Retrieve currently acquired discount coupons.

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}}/coupons?apiKey={{APIKey}}'

Responses

🟢200Success
application/json
Body
ok
boolean 
required
body
object 
required
totalReceived
integer 
required
Total number of SMS received so far
codes
array [object {8}] 
required
Example
{
    "ok": true,
    "body": {
        "totalReceived": 30,
        "codes": [
            {
                "userId": "userId",
                "code": "coupon code",
                "issuedAt": "2025-05-14 02:17:30",
                "expiredAt": "2025-06-14 02:17:30",
                "status": "issued",
                "timing": 30,
                "percentage": 10,
                "targetPay": "crypto"
            }
        ]
    }
}
Modified at 2025-05-30 14:02:49
Previous
Get invoices
Next
Get service list by country and carrier
Built with