ThreeSMS API Documentation

Use your API key to check balance, list services, get country/price data, buy SMS activation numbers and check incoming codes.

Get Your API Key

Create your personal API key from User Panel > Settings > API Access. Keep your key private and never share it publicly.

Authorization: Bearer ts_live_YOUR_API_KEY

Base URL

https://threesms.com/api/v1

1. Get Balance

GET /api/v1/balance
Authorization: Bearer ts_live_YOUR_API_KEY

2. List Services

GET /api/v1/services
Authorization: Bearer ts_live_YOUR_API_KEY

3. List Countries and Prices

GET /api/v1/countries?service=whatsapp
Authorization: Bearer ts_live_YOUR_API_KEY

4. Buy a Number

POST /api/v1/order
Authorization: Bearer ts_live_YOUR_API_KEY
Content-Type: application/json

{
  "service": "whatsapp",
  "country": "canada"
}

5. Check Order / SMS Code

GET /api/v1/order?id=ORDER_ID
Authorization: Bearer ts_live_YOUR_API_KEY

6. Cancel Order

POST /api/v1/cancel
Authorization: Bearer ts_live_YOUR_API_KEY
Content-Type: application/json

{
  "id": 123
}

cURL Example

curl -X GET "https://threesms.com/api/v1/balance" \
  -H "Authorization: Bearer ts_live_YOUR_API_KEY"

Note: API purchases use your USD wallet balance. Waiting orders without codes may be cancelled according to system rules and refunded to your balance.