Get 50% off your first order with code FIRST50
PanelLaunch
Get started

SMM Panel API Explained: Connect Providers and Child Panels (api/v2)

The SMM panel API lets you connect providers, child panels and automation. Here is how the PerfectPanel-compatible /api/v2 works and how to use it.

PanelLaunch Team 7 min read

On this page

Why the SMM panel API matters

The SMM panel API is what makes panels talk to each other. It's how your panel pulls services from providers, how child panels connect to your main panel, and how resellers automate orders. Most of the industry uses the PerfectPanel-compatible /api/v2 standard.

Think of the API as a short list of requests one panel can send another. Your panel uses it in two directions. Upstream, it sends your customers' orders to providers and reads back prices, statuses and your balance. Downstream, resellers and child panels use your panel's API to place orders with you, the same way you place orders with your providers.

You rarely need to touch the API by hand, because the panel makes these calls in the background. Knowing how it works still helps when you connect a new provider, debug a stuck order or explain to a reseller how to plug into your panel.

What the API lets you do

  • Place and check orders programmatically.
  • Sync services, prices and stock from providers automatically.
  • Power child panels so resellers can source from you.
  • Check balances and refill/cancel orders via code.

In practice, a reseller with their own panel or script can sell your services without ever visiting your site. Each of their orders arrives through the API, is charged to their balance on your panel and is forwarded to your provider like any other order.

How /api/v2 works

The standard /api/v2 accepts a simple POST with your API key and an action such as:

  • services — list available services and prices
  • add — create an order
  • status — check an order's status
  • balance — check account balance

Because it's PerfectPanel-compatible, most providers and child panels that already work with Perfect Panel will work with your panel out of the box.

Most panels use one endpoint for everything. Each request sends key and action as form fields, plus whatever that action needs, and the reply comes back as JSON. Beyond the four actions above, most panels also handle after-sales requests. Here is the common set:

Action What it does What you send
services Lists services with rates, minimums and maximums Just key and action
add Places an order service, link, quantity, plus optional extras
status Checks one order, or several at once An order ID, or a list in orders
refill Requests a refill on an order The order ID
refill_status Checks a refill request The refill ID returned by refill
cancel Asks to cancel orders The order IDs
balance Shows your balance and currency Just key and action

Field names vary a little between panels, and not every provider supports every action. Check each provider's API page before you rely on refill or cancel through the API.

What a request and response look like

Here is a balance check sent with curl. The address and key are placeholders:

curl -X POST https://provider.example/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

A typical reply:

{"balance": "100.84", "currency": "USD"}

Placing an order works the same way, with action=add plus service, link and quantity. If it succeeds, most panels return the new order ID, such as {"order": 23501}. Your panel stores that ID and uses it for every later status, refill or cancel request.

Optional extras: drip-feed and custom comments

Some services take extra fields on add. Drip-feed services accept runs and interval, which split one order into several smaller deliveries spaced over time. Custom-comment services accept a comments field with the comments to post, usually one per line. If a service does not support an extra, the provider may ignore it or reject the order, so check the service type first.

Checking many orders at once

The status action accepts a single order ID, or several IDs in orders, separated by commas. Panels use the bulk form to keep large order lists up to date without sending one request per order. SMM panel order statuses explained covers what each status means.

Do you need to code to use an SMM panel API?

No. As a panel owner, you paste a provider's API URL and key into your panel, and the panel makes every call for you. Coding only comes in if you want to automate something yourself, such as a reseller script, a bot or a report. Any language that can send an HTTP POST request will do.

Your resellers are in the same position. If they run their own panel, they add yours as a provider using your API URL and the key from their account. If they write their own tools, the table above covers most of what they need. For the owner-side setup, read how to add providers and connect an API.

Common API errors and what they usually mean

Most panels answer a bad request with a JSON object that contains an error field and a short message. The wording differs between panels, but the causes repeat: a wrong key, a missing or wrong service ID, a quantity outside the limits, a bad link, or too little balance to pay for the order.

  • Invalid key. The key was mistyped, copied with a space, or regenerated. Paste the current key again.
  • Incorrect service ID. The provider removed or renumbered the service. A fresh service sync shows what changed. On Pro and Business, Smart Provider Replacement re-points services to new provider IDs in bulk.
  • Quantity outside the limits. Your listing's minimum or maximum has drifted from the provider's. Refresh it.
  • Not enough funds. Your provider balance is too low. Top it up on the provider's site, then retry or resend the order with the failed-order tools.

When a provider stops answering altogether, the problem is on their side. SMM provider down: what to do walks through the next steps.

Keeping your API keys safe

An API key works like a password that can spend money. Anyone who has your provider key can place orders against your balance, and anyone with a reseller's key can spend that reseller's funds. Keep keys private, regenerate any key you think has leaked, and never share your admin password with anyone.

  • Keep keys out of chats and screenshots. Support groups, WhatsApp threads and screen recordings are easy places for a key to leak.
  • Keep keys out of public code. Never put a key in a web page, a public repository or a browser script.
  • Regenerate after a leak. Create a new key on the provider's site and paste it into your panel. A new key usually cancels the old one.
  • Never share your admin password. No provider or reseller needs it to place or fulfil orders.
  • Watch for spending you did not make. A provider balance that drops with no matching orders is a sign a key has leaked.

The SMM panel security checklist covers the rest of the basics.

Built-in and ready

Every PanelLaunch panel ships with a User API (/api/v2) for your resellers and providers, plus a Provider Manager to connect your upstream sources. No extra setup — it just works.

Here is how the pieces fit:

  • Provider Manager, on every plan, stores each provider's API URL and key and handles balances, sync and markup. Starter connects one API provider; Pro and Business connect unlimited.
  • User API, on every plan, lets your customers order programmatically with their own keys.
  • Child-panel selling, on every plan, lets resellers run their own panel that sources from yours. See how to sell child panels and what a child panel is.
  • Admin API comes with the Business plan.

If you were thinking of using a nulled Perfect Panel script to get this API, read the risks of nulled Perfect Panel scripts first. You can see the customer side of a working panel in the live demo without signing up, and compare plans on the pricing page.

Want a panel with a ready PerfectPanel-style API? Launch one and start connecting providers and child panels today.