SMM Panel API Documentation
A single REST endpoint to place orders, check status, pull balance and browse services — built for resellers, agencies, and developers automating growth across every platform SMM World supports.
Authentication
Every request is authenticated with your personal API key, found in your dashboard under Account → API. Send it as a key field in the POST body — never as a URL query parameter.
All requests are POST, all bodies and responses are application/json. Keep your API key secret — regenerate it immediately from your dashboard if it's ever exposed.
Add Order
Place a new order. Parameters vary by order type — select a type below.
| key | Your API key |
| action | add |
| service | Service ID |
| link | Link to page |
| quantity | Needed quantity |
| runs (optional) | Runs to deliver |
| interval (optional) | Interval in minutes |
1curl -X POST https://my.smmworld.org/api/v2 \
2 -H "Content-Type: application/json" \
3 -d '{
4 "key": "YOUR_API_KEY",
5 "action": "add",
6 "service": 1,
7 "link": "https://example.com/username",
8 "quantity": 1000
9 }'1{
2 "order": 23501
3}Service List
Pull the full, current list of services, categories, rates, and min/max limits.
| key | Your API key |
| action | services |
1curl -X POST https://my.smmworld.org/api/v2 \
2 -H "Content-Type: application/json" \
3 -d '{
4 "key": "YOUR_API_KEY",
5 "action": "services"
6 }'1[
2 {
3 "service": 1,
4 "name": "Followers",
5 "type": "Default",
6 "category": "First Category",
7 "rate": "0.90",
8 "min": "50",
9 "max": "10000",
10 "refill": true,
11 "cancel": true
12 },
13 {
14 "service": 2,
15 "name": "Comments",
16 "type": "Custom Comments",
17 "category": "Second Category",
18 "rate": "8",
19 "min": "10",
20 "max": "1500",
21 "refill": false,
22 "cancel": true
23 }
24]Order Status
Check the delivery status and remaining quantity for a single order.
| key | Your API key |
| action | status |
| order | Order ID |
1curl -X POST https://my.smmworld.org/api/v2 \
2 -H "Content-Type: application/json" \
3 -d '{
4 "key": "YOUR_API_KEY",
5 "action": "status",
6 "order": 23501
7 }'1{
2 "charge": "0.27819",
3 "start_count": "3572",
4 "status": "Partial",
5 "remains": "157",
6 "currency": "USD"
7}Multiple Orders Status
Check the status of up to 100 orders in a single call.
| key | Your API key |
| action | status |
| orders | Order IDs (separated by a comma, up to 100 IDs) |
1curl -X POST https://my.smmworld.org/api/v2 \
2 -H "Content-Type: application/json" \
3 -d '{
4 "key": "YOUR_API_KEY",
5 "action": "status",
6 "orders": "1,10,100"
7 }'1{
2 "1": {
3 "charge": "0.27819",
4 "start_count": "3572",
5 "status": "Partial",
6 "remains": "157",
7 "currency": "USD"
8 },
9 "10": {
10 "error": "Incorrect order ID"
11 },
12 "100": {
13 "charge": "1.44219",
14 "start_count": "234",
15 "status": "In progress",
16 "remains": "10",
17 "currency": "USD"
18 }
19}Create Refill
Submit a refill request for an eligible order (see Terms of Service for eligibility).
| key | Your API key |
| action | refill |
| order | Order ID |
1curl -X POST https://my.smmworld.org/api/v2 \
2 -H "Content-Type: application/json" \
3 -d '{
4 "key": "YOUR_API_KEY",
5 "action": "refill",
6 "order": 23501
7 }'1{
2 "refill": "1"
3}Create Multiple Refill
Submit refill requests for up to 100 eligible orders in a single call.
| key | Your API key |
| action | refill |
| orders | Order IDs (separated by a comma, up to 100 IDs) |
1curl -X POST https://my.smmworld.org/api/v2 \
2 -H "Content-Type: application/json" \
3 -d '{
4 "key": "YOUR_API_KEY",
5 "action": "refill",
6 "orders": "1,2,3"
7 }'1[
2 {
3 "order": 1,
4 "refill": 1
5 },
6 {
7 "order": 2,
8 "refill": 2
9 },
10 {
11 "order": 3,
12 "refill": {
13 "error": "Incorrect order ID"
14 }
15 }
16]Get Refill Status
Check the status of a previously submitted refill request.
| key | Your API key |
| action | refill_status |
| refill | Refill ID |
1curl -X POST https://my.smmworld.org/api/v2 \
2 -H "Content-Type: application/json" \
3 -d '{
4 "key": "YOUR_API_KEY",
5 "action": "refill_status",
6 "refill": 9814
7 }'1{
2 "status": "Completed"
3}Get Multiple Refill Status
Check the status of up to 100 refill requests in a single call.
| key | Your API key |
| action | refill_status |
| refills | Refill IDs (separated by a comma, up to 100 IDs) |
1curl -X POST https://my.smmworld.org/api/v2 \
2 -H "Content-Type: application/json" \
3 -d '{
4 "key": "YOUR_API_KEY",
5 "action": "refill_status",
6 "refills": "1,2,3"
7 }'1[
2 {
3 "refill": 1,
4 "status": "Completed"
5 },
6 {
7 "refill": 2,
8 "status": "Rejected"
9 },
10 {
11 "refill": 3,
12 "status": {
13 "error": "Refill not found"
14 }
15 }
16]Create Cancel
Request cancellation of one or more orders that support cancellation.
| key | Your API key |
| action | cancel |
| orders | Order IDs (separated by a comma, up to 100 IDs) |
1curl -X POST https://my.smmworld.org/api/v2 \
2 -H "Content-Type: application/json" \
3 -d '{
4 "key": "YOUR_API_KEY",
5 "action": "cancel",
6 "orders": "9,2"
7 }'1[
2 {
3 "order": 9,
4 "cancel": {
5 "error": "Incorrect order ID"
6 }
7 },
8 {
9 "order": 2,
10 "cancel": 1
11 }
12]User Balance
Retrieve your current account balance and currency.
| key | Your API key |
| action | balance |
1curl -X POST https://my.smmworld.org/api/v2 \
2 -H "Content-Type: application/json" \
3 -d '{
4 "key": "YOUR_API_KEY",
5 "action": "balance"
6 }'1{
2 "balance": "100.84292",
3 "currency": "USD"
4}Error Handling
Errors return HTTP 200 with an error field in the JSON body so client integrations can parse failures consistently, without relying on HTTP status codes alone.
| Error | Meaning |
|---|---|
| Incorrect API key | The key field is missing, malformed, or doesn't match an active account. |
| Not enough funds | Your account balance is lower than the order's total charge. |
| Invalid link | The submitted link doesn't match the expected format for the selected service's platform. |
| Min amount is X | The requested quantity is below the service's minimum order size. |
| Max amount is X | The requested quantity is above the service's maximum order size. |
| Service not found | The service ID doesn't exist or has been removed — refresh your services list. |
Notes for Integrators
- Poll order status sparingly — every few minutes is plenty. Excess polling on the same order provides no faster resolution.
- Store the numeric service ID from the services list rather than hardcoding names, since listings and IDs can change.
- Always validate the submitted link format client-side before calling add — invalid links are the most common cause of failed orders.
- Treat your API key like a password. Rotate it immediately from your dashboard if you suspect it has leaked.

