Api Documentations
HTTP Method POST
API URL https://smmvexgain.com/api/v2
API Key Get an API key on the Account page
Response format JSON
Service list
Parameters Description
key Your API key
action services

Example response

            [
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": true
    }
]
            

Note: refill and cancel are not currently included in the live response from this panel — only service, name, type, category, rate, min, max, desc are returned today.

Add order

Example response

            {
    "order": 23501
}
            
Order status
Parameters Description
key Your API key
action status
order Order ID

Example response

            {
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}
            
Multiple orders status
Parameters Description
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

Example response

            {
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "USD"
    }
}
            
Create refill
Parameters Description
key Your API key
action refill
order Order ID

Example response

            {
    "refill": "1"
}
            
Create multiple refill
Parameters Description
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

Example response

            [
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 2,
        "refill": 2
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]
            
Get refill status
Parameters Description
key Your API key
action refill_status
refill Refill ID

Example response

            {
    "status": "Completed"
}
            
Get multiple refill status
Parameters Description
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

Example response

            [
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 2,
        "status": "Rejected"
    },
    {
        "refill": 3,
        "status": {
            "error": "Refill not found"
        }
    }
]
            
Cancel orders
Parameters Description
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs). order with one ID also works.

Example response

[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": 1
    }
]
            
Speed up orders
Parameters Description
key Your API key
action speedup
orders Order IDs (separated by a comma, up to 100 IDs). order with one ID also works.

Example response

[
    {
        "order": 1,
        "speedup": 1
    },
    {
        "order": 2,
        "speedup": {
            "error": "#2 was already reported - please allow 12 hours."
        }
    }
]
            
Requests in plain words (for bots)
Parameters Description
key Your API key
action request
text Your customer's message as typed, e.g. 455566 speed, speeup 559999, refil 12 13, 8891 cancel, or several, one per line. Typos are understood. Bare order IDs mean "status".

Example response

{
    "results": [
        {"order": 455566, "action": "speedup", "ok": true, "task": 812},
        {"order": 559999, "action": "refill", "ok": false, "error": "#559999 can be refilled once it is completed."}
    ],
    "reply": "Speed-up requested for #455566.\n#559999 can be refilled once it is completed."
}
            
User balance
Parameters Description
key Your API key
action balance

Example response

            {
    "balance": "100.84292",
    "currency": "USD"
}
            
🤖 Automation features - list and track your orders, get details, never pay twice for a retried order (external_id), and receive status changes automatically on your server (webhooks).
Add order without double charges (external_id)
ParametersDescription
keyYour API key
actionadd
serviceService ID
linkLink to page
quantityNeeded quantity
external_idYour own unique ID for this order (e.g. your job or invoice ID). Sending the same external_id again returns the first order instead of placing and charging a new one - safe to retry after a timeout.

Example response

{
    "order": 23501
}
// the same external_id again:
{
    "order": 23501,
    "duplicate": true
}
List orders
ParametersDescription
keyYour API key
actionorders
statusOptional: pending, in progress, processing, completed, partial, canceled (comma separated)
serviceOptional: service ID
since_idOptional: only orders newer than this order ID (oldest first) - ideal for syncing
from / toOptional: dates, e.g. 2026-11-01
searchOptional: part of the link
page / limitOptional: page number, and 1-100 per page (default 50)

Example response

{
    "orders": [
        {
            "order": 23501,
            "external_id": "job-777",
            "service": 1,
            "link": "https://www.instagram.com/p/xyz",
            "quantity": 1000,
            "charge": "0.27819",
            "currency": "USD",
            "start_count": "3572",
            "remains": "157",
            "status": "In progress",
            "progress": 84,
            "created": "2026-11-03T06:34:09+03:00"
        }
    ],
    "page": 1,
    "limit": 50,
    "total": 1,
    "pages": 1
}
Order details
ParametersDescription
keyYour API key
actionorder
orderOrder ID (or external_id instead)

Example response

{
    "order": 23501,
    "service_name": "Instagram Likes",
    "status": "Completed",
    "progress": 100,
    "refill": true,
    "refill_days": 30,
    "can_refill": true,
    "can_cancel": false,
    ...
}
Service details

Tip: action=services also accepts category (ID or name) and search filters, and every service now shows refill and cancel.

ParametersDescription
keyYour API key
actionservice
serviceService ID

Example response

{
    "service": 1,
    "name": "Instagram Likes",
    "category": "Instagram",
    "rate": "0.90",
    "currency": "USD",
    "min": 50,
    "max": 10000,
    "refill": true,
    "refill_days": 30,
    "cancel": false,
    "dripfeed": false,
    "desc": "..."
}
Categories
ParametersDescription
keyYour API key
actioncategories

Example response

[
    {"category": 3, "name": "Instagram Likes", "services": 12},
    {"category": 7, "name": "TikTok Views", "services": 9}
]
Account
ParametersDescription
keyYour API key
actionaccount

Example response

{
    "username": "reseller1",
    "balance": "100.84292",
    "currency": "USD",
    "spent": "5320.10",
    "discount": 5,
    "orders": {"completed": 1840, "inprogress": 12, "pending": 3},
    "webhook": {"url": "https://example.com/smm-hook", "active": true}
}
Webhooks: get order updates automatically

Answer with any 2xx code. Failed deliveries are retried every minute (switched off after 60 failures in a row - see webhook_get).

ParametersDescription
keyYour API key
actionwebhook_set (or webhook_get, webhook_test, webhook_delete)
urlYour HTTPS address that receives the updates (webhook_set only)

Example response

{
    "ok": true,
    "url": "https://example.com/smm-hook",
    "secret": "9f2c…"
}
// every minute we POST the orders that changed:
{
    "event": "orders.updated",
    "time": "2026-11-03T06:40:00+03:00",
    "orders": [ { "order": 23501, "external_id": "job-777", "status": "Completed", "remains": "0", "progress": 100, ... } ]
}
// check it is really from us (PHP):
$body = file_get_contents('php://input');
$ok = hash_equals('sha256=' . hash_hmac('sha256', $_SERVER['HTTP_X_WEBHOOK_TIMESTAMP'] . '.' . $body, $secret),
                  $_SERVER['HTTP_X_WEBHOOK_SIGNATURE']);
Telegram Support Chat with our support team ↗ Join Telegram Channel Get updates and announcements ↗
WhatsApp Support Chat with us
WhatsApp Channel Follow our updates