Table of Contents
Interactive Sandbox
Zero Postman needed. Test live API requests with your real account balance directly inside your browser.
Launch Live ConsoleSMM v2 Reseller API Documentation
Industry-standard protocol for automated order fulfillment, service synchronization, and live balance telemetry.
Authentication & API Key
How to authenticate your reseller API requests
Every request sent to the SMM v2 gateway must include your secret API key as a request parameter named key.
You can inspect or rotate your live API key at any time in the Developer Portal or under Settings → API Key.
Endpoints Reference
Service List
Fetch complete catalog of all active composite bundles and direct provider services with current rates per 1,000, minimum and maximum limits, and refill/cancellation flags.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your private customer API key. |
| action | string | Required | Value must be "services". |
curl -X POST "https://boostysmm.com/api/v2" \ -d "key=YOUR_API_KEY&action=services"
[
{
"service": "1a3d421b-7790-49b2-8834-790da258b20c",
"name": "Instagram Post Shares | Non Drop | Real Active",
"type": "Default",
"category": "Instagram Engagement",
"rate": "0.04",
"min": "10",
"max": "60000",
"refill": false,
"cancel": true,
"desc": "High quality shares delivered with drip pacing."
}
]Check Balance
Retrieve current live wallet funds balance and operational currency (USD) assigned to your API credential.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your private customer API key. |
| action | string | Required | Value must be "balance". |
curl -X POST "https://boostysmm.com/api/v2" \ -d "key=YOUR_API_KEY&action=balance"
{
"balance": "500.00",
"currency": "USD"
}Create Order
Place a new automated order. Funds are atomically deducted from your wallet and immediately enqueued for provider dispatch. Supports standard orders, custom comments, and drip-feed automation.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your private customer API key. |
| action | string | Required | Value must be "add". |
| service | string | Required | Service ID from action=services. |
| link | string | Required | Destination profile or post URL. |
| quantity | integer | Required | Quantity between service min and max limits. |
| comments | string | Optional | Custom comments newline-separated (for Custom Comments services). |
| runs | integer | Optional | Total drip-feed runs (optional). |
| interval | integer | Optional | Drip-feed interval in minutes (optional). |
curl -X POST "https://boostysmm.com/api/v2" \ -d "key=YOUR_API_KEY" \ -d "action=add" \ -d "service=1a3d421b-7790-49b2-8834-790da258b20c" \ -d "link=https://www.instagram.com/p/Cxyz1234/" \ -d "quantity=1000"
{
"order": "e6726014-739a-400c-a1bf-6859b33d9449"
}Order Status (Single)
Inspect real-time progress, financial charge, start count, and remaining count of an individual order.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your private customer API key. |
| action | string | Required | Value must be "status". |
| order | string | Required | Order ID returned by action=add. |
curl -X POST "https://boostysmm.com/api/v2" \ -d "key=YOUR_API_KEY&action=status&order=e6726014-739a-400c-a1bf-6859b33d9449"
{
"charge": "0.0400",
"start_count": "1520",
"status": "In progress",
"remains": "350",
"currency": "USD"
}Batch Orders Status
Check status for up to 100 orders simultaneously in a single HTTP request using a comma-separated list.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your private customer API key. |
| action | string | Required | Value must be "status". |
| orders | string | Required | Comma-separated order IDs, e.g. "id1,id2,id3". |
curl -X POST "https://boostysmm.com/api/v2" \ -d "key=YOUR_API_KEY&action=status&orders=e6726014-739a-400c-a1bf-6859b33d9449,f429188a-330e-4731-95c9-943029410ef1"
{
"e6726014-739a-400c-a1bf-6859b33d9449": {
"charge": "0.0400",
"start_count": "1520",
"status": "In progress",
"remains": "350",
"currency": "USD"
},
"f429188a-330e-4731-95c9-943029410ef1": {
"charge": "1.2000",
"start_count": "500",
"status": "Completed",
"remains": "0",
"currency": "USD"
}
}Request Refill
Initiate a refill restoration request for an eligible order that experienced drops within the warranty window.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your private customer API key. |
| action | string | Required | Value must be "refill". |
| order | string | Required | Order ID to refill. |
curl -X POST "https://boostysmm.com/api/v2" \ -d "key=YOUR_API_KEY&action=refill&order=e6726014-739a-400c-a1bf-6859b33d9449"
{
"refill": "REF-e67260-413370"
}Check Refill Status
Check current resolution status of an initiated refill request.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your private customer API key. |
| action | string | Required | Value must be "refill_status". |
| refill | string | Required | Refill ID returned by action=refill. |
curl -X POST "https://boostysmm.com/api/v2" \ -d "key=YOUR_API_KEY&action=refill_status&refill=REF-e67260-413370"
{
"status": "Completed"
}Cancel Order
Cancel an order before it starts processing. Remaining unfulfilled amounts are atomically credited back to your wallet balance.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your private customer API key. |
| action | string | Required | Value must be "cancel". |
| order | string | Required | Order ID or comma-separated orders to cancel. |
curl -X POST "https://boostysmm.com/api/v2" \ -d "key=YOUR_API_KEY&action=cancel&order=e6726014-739a-400c-a1bf-6859b33d9449"
{
"order": "e6726014-739a-400c-a1bf-6859b33d9449",
"cancel": 1
}Standard Error Responses
Error schemas and common resolution steps
| Error Message | Cause | Resolution |
|---|---|---|
| {"error":"Bad API key"} | The "key" parameter is missing, expired, or invalid. | Verify the key in your Developer API settings or regenerate a new one. |
| {"error":"Not enough funds on balance"} | Wallet balance is lower than the calculated order cost. | Deposit funds into your wallet balance under the Wallet section. |
| {"error":"Incorrect order ID"} | The specified order ID does not exist or belongs to another user. | Confirm the order UUID returned in the action=add response. |
| {"error":"Quantity must be between min and max"} | The quantity passed is outside the allowed bounds. | Call action=services to check min and max values before placing order. |
| {"error":"Order cannot be canceled in its current status"} | The order has already begun processing or is completed. | Only orders in Pending status can be canceled. |
Reseller Platform Integration
Connect BoostySMM as an automated provider in your panel
PerfectPanel Setup
Standard v2- Go to Providers → Add Provider in your PerfectPanel admin.
- Set API Type to
Standard / SMM v2. - Set API URL to
https://boostysmm.com/api/v2. - Paste your BoostySMM API Key.
- Click Save & Synchronize to import services.
RentalPanel / Custom Script
Standard v2- Open Settings → Provider Connections.
- Choose Standard SMM v2 as protocol.
- Enter
https://boostysmm.com/api/v2as the Provider API Host. - Provide your secret API Key.
- Test connection with Sync Balance to verify.