REST API · Version 1

API Reference

Automate orders, top-ups and status checks by talking to Best SMM Panel | Real Services - SureSMM directly. Every request is a single POST with your API key — responses come back as clean JSON.

POST https://suresmm.com/api/v1
JSON response Key auth 120 req/min
Getting started

Authentication

Every call is authenticated with your personal API key. Grab it from your dashboard under Account → API, then send it as the key parameter on each request.

Parameter Type Description Required
key string Your unique API key Required
action string The endpoint action — e.g. services, add, status, refill, balance Required
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"
GET /services

Service list

Returns the full catalogue of services with live rates, limits and refill/drip-feed support.

Parameter Type Description
key string Your API key
action string "services"
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=services"
200 Response
[
  {
    "service": 1,
    "name": "YouTube Livestream Viewers",
    "rate": "0.33000000",
    "min": 1000,
    "max": 200000,
    "category": "Live Stream",
    "refill": true,
    "dripfeed": true
  }
]
POST /add

Add order

Place a new order against a service. Optional drip-feed fields let you split delivery into runs.

Parameter Type Description Required
key string Your API key Required
action string "add" Required
service integer Service ID Required
link string Link to page Required
quantity integer Quantity to be delivered Required
runs integer Runs to deliver Optional
interval integer Interval in minutes Optional
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://example.com/post" \
  -d "quantity=1000"
200 Response
{
  "order": 1242
}
POST /status

Order status

Check the progress of any order — status, start count and remaining quantity.

Parameter Type Description
key string Your API key
action string "status"
order integer Order ID
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=1242"
200 Response
{
  "status": "Pending",
  "start_count": "1000",
  "remains": "500",
  "currency": "USD"
}
Available statuses
Pending Processing Completed Partial Cancelled Refunded
POST /refill

Refill

Request a refill for an eligible order, then poll its refill status until completed.

Create refill

Parameter Type Description
key string Your API key
action string "refill"
order integer Order ID
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=refill" \
  -d "order=1242"
200 Response
{
  "success": "Your order will be refilled asap. Thank you for your patience",
  "refill": 12345
}

Refill status

Parameter Type Description
key string Your API key
action string "refill_status"
refill integer Refill ID
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=refill_status" \
  -d "refill=12345"
200 Response
{
  "status": "Completed"
}
POST /balance

User balance

Fetch the current account balance and its currency.

Parameter Type Description
key string Your API key
action string "balance"
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"
200 Response
{
  "balance": "100.84292",
  "currency": "USD"
}
Reference

Error responses

When a request is invalid the API returns a JSON object with an error message. The common ones are listed below.

The action field is required
The api key field is required
Invalid api key
Invalid action
Invalid Service Id
The link field is required
The quantity field is required
Please follow the limit
Insufficient balance
The order field is required
Invalid Order Id
Order not eligible for refill
Error shape
{
  "error": "Invalid api key"
}
Chat with us