API Documentation
The ClassySMM API allows you to integrate our social media services into your own platform or reseller panel. All prices are in Nigerian Naira (NGN). The API follows the standard SMM panel protocol.
https://classysmm.com/api/v2
| Property | Value |
|---|---|
| HTTP Method | POST |
| Content-Type | application/x-www-form-urlencoded or application/json |
| Response Format | JSON |
| Currency | NGN (₦ Nigerian Naira) |
| Encoding | UTF-8 |
Authentication
Every API request must include your unique API key. Your key is found in your dashboard under Profile & API Key.
POST https://classysmm.com/api/v2
key=YOUR_API_KEY&action=services
Error Handling
All errors return a JSON object with an error key describing the issue.
{
"error": "Insufficient balance."
}
| Error | Meaning |
|---|---|
| Invalid API key. | The key provided does not match any account. |
| Insufficient balance. | User wallet does not have enough funds. |
| Service not found or unavailable. | Service ID does not exist or is inactive. |
| Quantity must be between X and Y. | Quantity is outside the service min/max limits. |
| Rate limit exceeded. | More than 60 requests per minute. |
Service List
Returns all active services with their pricing in NGN. Prices differ based on your account type (smart, vendor, api).
POSThttps://classysmm.com/api/v2| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be services |
[
{
"service": 1,
"name": "Instagram Followers",
"type": "Default",
"category": "Instagram Followers",
"rate": "450.0000",
"min": 100,
"max": 100000,
"refill": true,
"cancel": false,
"currency": "NGN"
}
]
Add Order
Place a new order. The charge is deducted from your wallet immediately. Prices are per 1,000 units in NGN.
POSThttps://classysmm.com/api/v2| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be add |
| service | integer | Required | Service ID from the services list |
| link | string | Required | URL of the target page/profile |
| quantity | integer | Required | Number of units to order |
| runs | integer | Optional | Number of runs (drip-feed) |
| interval | integer | Optional | Interval in minutes (drip-feed) |
{
"order": 10482
}
Order Status
Check the status of a single order using its order ID returned from the Add Order action.
POSThttps://classysmm.com/api/v2| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be status |
| order | integer | Required | Order ID |
{
"charge": "450.0000",
"start_count": 1240,
"status": "In progress",
"remains": 700,
"currency": "NGN"
}
Multiple Orders Status
Check the status of up to 100 orders in a single request.
POSThttps://classysmm.com/api/v2| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be status |
| orders | string | Required | Comma-separated order IDs (max 100) |
{
"10482": {
"charge": "450.0000",
"start_count": 1240,
"status": "Completed",
"remains": 0,
"currency": "NGN"
},
"10499": {
"error": "Incorrect order ID"
}
}
Create Refill
Request a refill for an order. Only available for services that support refill. Check the refill field in the services list.
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be refill |
| order | integer | Required | Order ID to refill |
{
"refill": "1"
}
Refill Status
Check the status of a refill request.
POSThttps://classysmm.com/api/v2| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be refill_status |
| refill | string | Required | Refill ID |
| refills | string | Optional | Comma-separated refill IDs (bulk) |
{
"status": "Completed"
}
Cancel Orders
Cancel one or more orders. Only works for services with cancel: true and orders in eligible statuses. Refund for undelivered quantity is automatic.
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be cancel |
| orders | string | Required | Comma-separated order IDs |
[
{
"order": 10482,
"cancel": 1
},
{
"order": 10499,
"cancel": { "error": "This service does not support cancellation." }
}
]
User Balance
Returns your current wallet balance in NGN.
POSThttps://classysmm.com/api/v2| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | Required | Your API key |
| action | string | Required | Must be balance |
{
"balance": "12500.0000",
"currency": "NGN"
}