SMM WhatsApp ChatBot - API Documentation

API Authentication

Authentication Methods

All API endpoints require authentication via API key:

  • POST Requests: Include api_key in request body
  • GET Requests: Include api_key as query parameter
  • Alternative: Use authentication field instead of api_key

API Endpoints - Request & Response

GET https://smmchatbots.com/api.php

Description: Get API information and list all available endpoints

Authentication: Not required

Request Success Response
GET https://smmchatbots.com/api.php
POST https://smmchatbots.com/api.php/user

Description: Login or register new user

Authentication: api_key required

Request Success Response Error Response
{
  "api_key": "YOUR_API_KEY",
  "phone_number": "{{{senderMobile}}}",
  "name": "{{{senderName}}}"
}
GET https://smmchatbots.com/api.php/services

Description: Get list of all available services grouped by categories

Authentication: api_key parameter

Request Success Response
GET /api.php/services?api_key=YOUR_API_KEY
POST https://smmchatbots.com/api.php/order/calculate

Description: Calculate order price before creating order

Authentication: api_key required

Request Success Response
{
  "api_key": "YOUR_API_KEY",
  "phone_number": "{{{senderMobile}}}",
  "service_name": "Instagram Followers",
  "quantity": "{{{quantity}}}"
}
POST https://smmchatbots.com/api.php/order

Description: Create a new order

Authentication: api_key required

Request Success Response Error Response
{
  "api_key": "YOUR_API_KEY",
  "phone_number": "{{{senderMobile}}}",
  "service_name": "insta likes",
  "link": "{{{servicelink}}}",
  "payment_mode": "{{{paymentmode}}}",
  "payment_method": "{{{gateway}}}",
  "quantity": "{{{quantity}}}"
}
GET https://smmchatbots.com/api.php/order/{{{orderid}}}

Description: Get status of a specific order

Authentication: api_key parameter

Request Success Response
GET https://smmchatbots.com/api.php/order/{{{orderid}}}?api_key=YOUR_API_KEY
POST https://smmchatbots.com/api.php/payment/initiate - Initiate Payment

Description: Initiate payment/top up balance

Authentication: api_key required

Request Success Response Pending Response
{
  "api_key": "YOUR_API_KEY",
  "phone_number": "{{{senderMobile}}}",
  "mobile_phone_number": "{{{Paymentnumber}}}",
  "payment_method": "{{{gateway}}}",
  "amount": "{{{amount}}}"
}

Status Codes & Responses

Status Code Description Example Response
200 Success {"status": "success", "data": {...}}
400 Bad Request {"status": "error", "message": "Missing required fields"}
401 Unauthorized {"status": "error", "message": "Invalid API key"}
402 Insufficient Balance {"status": "error", "message": "Insufficient balance"}
404 Not Found {"status": "error", "message": "Service not found"}
500 Server Error {"status": "error", "message": "Internal server error"}
Need Help?

For technical support or questions, please contact your system administrator.

support@smmchatbots.com
+1 (787) 904-5829
24/7 Support

Documentation last updated: March 7, 2026