SMM Panel API - IA-Café Documentation

💰

API User Pricing — You Pay Less

As an API user you get a special discounted price on all SMM services. Prices are updated automatically every day using the live NGN/USD exchange rate. The rate_ngn_per_1k field in the services response already shows your discounted API price — no need to calculate anything.

📚 Available Endpoints

Method	Endpoint	Description
GET	`/smm/services`	Get all active SMM services with NGN prices
POST	`/smm/order`	Place a new SMM order
GET	`/smm/orders`	List your SMM orders (paginated)
GET	`/smm/status/:id`	Get live status of a single order
POST	`/smm/status`	Get status of multiple orders at once
POST	`/smm/refill`	Request a refill for a dropped order
GET	`/smm/refill-status`	Check status of a refill request
POST	`/smm/cancel`	Cancel one or more active orders

📋 Step 1 — Get Available Services

Fetch all active SMM services. Use the optional filters to narrow down results. The rate_ngn_per_1k is your API price per 1,000 units in Naira — already discounted, updated daily with the live exchange rate.

GET /devapi/v1/smm/services

Optional Query Parameters

Parameter	Example	Description
`category`	`Instagram`	Filter by exact category name
`q`	`followers`	Search by service name or category

cURL — Get All Services

curl -X GET "https://iacafe.com.ng/devapi/v1/smm/services" \
  -H "Authorization: Bearer YOUR_API_KEY"

cURL — Filter by Category

curl -X GET "https://iacafe.com.ng/devapi/v1/smm/services?category=Instagram" \
  -H "Authorization: Bearer YOUR_API_KEY"

cURL — Search Services

curl -X GET "https://iacafe.com.ng/devapi/v1/smm/services?q=followers" \
  -H "Authorization: Bearer YOUR_API_KEY"

          Response
        

{
  "success": true,
  "message": "SMM services retrieved",
  "count": 3,
  "categories": [
    "Facebook",
    "Instagram",
    "TikTok"
  ],
  "filters": {
    "category": null,
    "search": null
  },
  "data": {
    "services": [
      {
        "id": 101,
        "provider_service_id": 1,
        "category": "Instagram",
        "name": "IG Followers [Real - 30 Days Refill]",
        "type": "Default",
        "min": 100,
        "max": 100000,

        // Your API price per 1,000 units in Naira
        // This is already discounted — updated daily with live FX rate
        "rate_ngn_per_1k": 1040.00,

        
  "refill": true,
        "cancelable": true,
        "dripfeed": false
      }
    ]
  }
}
        

Service Fields Explained

Field	Type	Description
`id`	number	Use this as `serviceId` when placing an order
`rate_ngn_per_1k`	number	Your API price per 1,000 units in ₦ Naira. Cost = `(quantity / 1000) × rate_ngn_per_1k`
`min`	number	Minimum quantity you can order
`max`	number	Maximum quantity you can order
`refill`	boolean	`true` = you can request a free refill if count drops
`cancelable`	boolean	`true` = you can cancel this order while it is still active
`dripfeed`	boolean	`true` = drip feed delivery is supported (gradual delivery over time)

🛒 Step 2 — Place an Order

Place a new SMM order. The cost in Naira is automatically calculated and deducted from your wallet. You must send a unique request_id with every order to prevent duplicates.

POST /devapi/v1/smm/order

Request Parameters

Parameter	Required	Description
`request_id`	✅ Always	Unique ID you generate for this request. Used to prevent duplicate orders. Also accepted as: `requestId`, `ref`
`serviceId`	✅ Always	The `id` from GET /smm/services. Also accepted as: `service_id`, `service`
`link`	✅ Standard orders	Full URL or @username of the target. Also accepted as: `url`, `target`
`quantity`	✅ Standard orders	How many units to order. Must be between service `min` and `max`. Also accepted as: `qty`, `count`
`comments`	✅ Custom Comments only	One comment per line. Quantity = number of lines. Also accepted as: `comment`

💡 How Your Cost Is Calculated

cost = (quantity / 1000) × rate_ngn_per_1k

Example:
Service rate: ₦1,040 per 1,000
Quantity: 1,500
Cost = (1500 / 1000) × 1040 = ₦1,560

This is deducted from your wallet automatically when the order is placed. If the provider fails — your wallet is refunded immediately.

cURL — Standard Order (Followers / Likes / Views)

curl -X POST "https://iacafe.com.ng/devapi/v1/smm/order" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "my_order_001",
    "serviceId": 101,
    "link": "https://instagram.com/yourpage",
    "quantity": 1500
  }'

cURL — Custom Comments Order

curl -X POST "https://iacafe.com.ng/devapi/v1/smm/order" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "my_order_002",
    "serviceId": 205,
    "link": "https://instagram.com/p/postid",
    "comments": "Amazing post!\nLove this content!\nGreat work!"
  }'

          Success Response
        

{
  "code": "success",
  "message": "ORDER PROCESSING",
  "data": {
    "product_name": "SMM",
    "service_name": "IG Followers [Real - 30 Days Refill]",
    "status": "processing-api",
    "order_id": 98765,
    "provider_order_id": 554433,
    "link": "https://instagram.com/yourpage",
    "quantity": 1500,
    "amount": "1560.00",
    "discount": "0.00",
    "amount_charged": "1560.00",
    "initial_balance": "10000.00",
    "final_balance": "8440.00",
    "request_id": "my_order_001"
  }
}
        

Common Error Responses

          Error — Quantity Out of Range
        

{
  "success": false,
  "error": {
    "code": "invalid_quantity",
    "message": "Quantity must be between 100 and 100000"
  },
  "received": 50,
  "min": 100,
  "max": 100000
}
        

          Error — Insufficient Balance
        

{
  "success": false,
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient wallet balance"
  }
}
        

          Error — Provider Failed (Wallet Refunded)
        

{
  "code": "refunded",
  "message": "Order could not be completed. Wallet refunded.",
  "data": {
    "order_id": 98765,
    "request_id": "my_order_001"
  }
}
        

📡 Check Order Status

Get the live status of an order directly from the provider. The local database is updated automatically with the latest status.

GET /devapi/v1/smm/status/:id

cURL

curl -X GET "https://iacafe.com.ng/devapi/v1/smm/status/98765" \
  -H "Authorization: Bearer YOUR_API_KEY"

          Response
        

{
  "success": true,
  "data": {
    "order": {
      "id": 98765,
      "provider_order_id": 554433,
      "service_name": "IG Followers [Real - 30 Days Refill]",
      "link": "https://instagram.com/yourpage",
      "quantity": 1500,
      "amount_ngn": 1560.00,
      "status": "in progress",
      "start_count": 4200,
      "remains": 900,
      "can_refill": true,
      "can_cancel": true,
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T11:00:00Z"
    },
    "provider": {
      "status": "In progress",
      "start_count": "4200",
      "remains": "900",
      "charge": "0.975",
      "currency": "USD"
    }
  }
}
        

Possible Status Values

Status	Meaning
`pending`	Order received, waiting to start
`in progress`	Order is currently being delivered
`processing`	Being processed by provider
`completed`	Order fully delivered ✅
`partial`	Partially delivered — some could not be completed
`cancelled`	Order was cancelled
`failed`	Order failed to deliver

📡 Bulk Order Status

Check the status of up to 100 orders in a single request. Much faster than calling the single status endpoint repeatedly.

POST /devapi/v1/smm/status

cURL

curl -X POST "https://iacafe.com.ng/devapi/v1/smm/status" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orderIds": [98765, 98766, 98767]
  }'

          Response
        

{
  "success": true,
  "message": "Bulk status retrieved",
  "data": {
    "554433": {
      "status": "In progress",
      "remains": "900",
      "charge": "0.975",
      "currency": "USD"
    },
    "554434": {
      "status": "Completed",
      "remains": "0",
      "charge": "1.30",
      "currency": "USD"
    }
  }
}
        

📜 List Your Orders

Get a paginated list of all your SMM orders. Filter by status or service ID.

GET /devapi/v1/smm/orders

Parameter	Default	Description
`page`	1	Page number
`limit`	20	Results per page (max 100)
`status`	—	Filter by status: `pending`, `processing`, `completed`, `partial`, `cancelled`, `failed`
`service_id`	—	Filter by service ID

cURL

curl -X GET "https://iacafe.com.ng/devapi/v1/smm/orders?page=1&limit=20&status=processing" \
  -H "Authorization: Bearer YOUR_API_KEY"

          Response
        

{
  "success": true,
  "data": {
    "orders": [
      {
        "id": 98765,
        "service_name": "IG Followers [Real - 30 Days Refill]",
        "category": "Instagram",
        "link": "https://instagram.com/yourpage",
        "quantity": 1500,
        "amount_ngn": 1560.00,
        "status": "processing",
        "remains": 900,
        "can_refill": true,
        "can_cancel": true,
        "created_at": "2025-01-15T10:30:00Z"
      }
    ]
  },
  "pagination": {
    "total": 45,
    "count": 20,
    "limit": 20,
    "page": 1,
    "pages": 3
  }
}
        

🔄 Request a Refill

If your follower or like count drops after delivery, you can request a free refill — as long as the service supports it (can_refill: true in the order response). Refills are free — no extra charge.

POST /devapi/v1/smm/refill

cURL

curl -X POST "https://iacafe.com.ng/devapi/v1/smm/refill" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": 98765
  }'

          Response
        

{
  "success": true,
  "message": "Refill request submitted successfully",
  "data": {
    "refill": 7821
  }
}
        

Check Refill Status

GET /devapi/v1/smm/refill-status?refill=7821

cURL — Single Refill

curl -X GET "https://iacafe.com.ng/devapi/v1/smm/refill-status?refill=7821" \
  -H "Authorization: Bearer YOUR_API_KEY"

cURL — Multiple Refills

curl -X GET "https://iacafe.com.ng/devapi/v1/smm/refill-status?refills=7821,7822,7823" \
  -H "Authorization: Bearer YOUR_API_KEY"

          Response
        

{
  "success": true,
  "message": "Refill status retrieved",
  "data": {
    "status": "Completed"
  }
}
        

❌ Cancel Orders

Cancel one or more active orders. Only works if the service supports cancellation (can_cancel: true) and the order is not yet completed or failed. Successfully cancelled orders are refunded automatically.

POST /devapi/v1/smm/cancel

cURL

curl -X POST "https://iacafe.com.ng/devapi/v1/smm/cancel" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orderIds": [98765, 98766]
  }'

          Response
        

{
  "success": true,
  "message": "Cancel request submitted",
  "cancelled_count": 2,
  "data": [
    {
      "order": 554433,
      "cancel": 1
    },
    {
      "order": 554434,
      "cancel": 1
    }
  ]
}
        

          Response — Order Not Cancelable
        

{
  "success": true,
  "message": "No cancelable orders found",
  "data": [],
  "note": "Orders must be cancelable, still active, and confirmed with provider"
}
        

⚡ Quick Reference

Parameter	Alternative Names Accepted
`request_id`	`requestId`, `ref`
`serviceId`	`service_id`, `service`
`link`	`url`, `target`
`quantity`	`qty`, `count`
`comments`	`comment`
`orderIds`	`order_ids`, `ids`
`orderId`	`order_id`, `id`