API reference
| Action | Required fields | Response |
|---|---|---|
| services | key, action | Service list with rate, type, min, max, refill and cancel |
| balance | key, action | balance, currency |
| add | key, action, service, link (or url), quantity | order |
| status | key, action, order (or orders, max 100 comma-separated IDs) | charge, start_count, status, remains, currency |
| refill | key, action, order (or orders, up to 100) | Request acceptance and task ID |
| cancel | key, action, order (or orders, up to 100) | Request acceptance and task ID |
| refill_status | key, action, refill (or refills, up to 100) | Refill status; each ID belongs to your account |
Connect as a provider
Method: POST · Form fields: key and action · Response: JSON. Use https://smmde.net/api/v2. The same key also works at /api, with or without a trailing slash. Use your full generated key, not its shortened preview.
Some hosted panel platforms require approval of a new provider domain. Their approval is separate from a successful API connection; changing your key does not approve the provider.
Add an order
curl https://smmde.net/api/v2 \ --data-urlencode 'key=YOUR_PRIVATE_KEY' \ --data-urlencode 'action=add' \ --data-urlencode 'service=SERVICE_ID' \ --data-urlencode 'link=https://example.com/profile' \ --data-urlencode 'quantity=100' \ --data-urlencode 'order_reference=YOUR_UNIQUE_REFERENCE'
Reuse the same order_reference when retrying the same order after a lost response. Do not reuse it for different order data. Custom comment services accept comments, one per line. Additional fields depend on the service’s configuration.
Example success: {"order": 123}. Errors use {"error": "message"} with an HTTP error status. API keys never belong in URLs or public frontend code.
Response examples
balance → {"balance":"100.00000000","currency":"INR"}
status → {"charge":"1.00000000","start_count":"0","status":"Pending","remains":"100","currency":"INR"}
refill → {"refill":123} (additional acceptance fields may be present)
cancel, orders=123 → [{"order":123,"cancel":1}]
refill_status → {"status":"Completed"}Bulk status returns an object keyed by order ID. Bulk refill/cancel/refill-status returns an array. Send up to 100 comma-separated IDs; invalid or foreign IDs receive an individual error. Custom Comments can omit quantity: nonempty comment lines determine it. Package services can omit quantity. API drip-feed scheduling is not advertised or enabled.
Request accepted does not mean completed
Refill and cancellation requests are queued for provider review. Poll order status for the final outcome. Ambiguous provider submissions enter Unknown for staff reconciliation rather than being sent twice.