Customer API (v2)

For developers — connect your own panel, bot or website.

Introduction

Every request is a POST (form or JSON) to a single URL. The action parameter selects what to do. Responses are always JSON; errors look like {"error": "…"}.

URL
https://foydaads.uz/api/v2
Method
POST
Format
JSON

Quick start

  1. 1Sign in and create a key under Profile → API key.
  2. 2Top up your balance — orders are charged from it.
  3. 3Get a service ID via services, place an order with add, track it with status.
POST/api/v2

Add order

All prices are in UZS. Boosting price (rate) is per 1000; numbers/Stars/Premium are per item.

curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=1 \
  -d link=https://t.me/your_channel \
  -d quantity=1000
Response
{ "order": 23501 }
POSTaction=services

All active services with prices and limits.

Parameters

key
stringrequired
Your API key
action
stringrequired
services
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services
Response
[
  {
    "service": 1,
    "name": "Telegram — kanal obunachilari",
    "type": "Default",
    "category": "Telegram — members",
    "rate": "9900",
    "min": 100,
    "max": 50000,
    "refill": true,
    "cancel": false,
    "dripfeed": false,
    "currency": "UZS"
  }
]
POSTaction=add

Creates a new order. The cost is deducted from your balance.

Parameters

key
stringrequired
Your API key
action
stringrequired
add
service
integerrequired
Service ID (from services)
link
stringrequired
Channel/post link. For Stars and Premium — the recipient’s @username
quantity
integerrequired
Quantity (within min–max)
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=1 \
  -d link=https://t.me/your_channel \
  -d quantity=1000
Response
{ "order": 23501 }
POSTaction=status

Status of a single order.

For number orders, the status response includes phone, code and password fields.

Parameters

key
stringrequired
Your API key
action
stringrequired
status
order
integerrequired
Order ID
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d order=23501
Response
{
  "charge": "9900",
  "start_count": "3572",
  "status": "Partial",
  "remains": "157",
  "currency": "UZS"
}
POSTaction=status

Multiple order status

Up to 100 orders, comma-separated.

Parameters

key
stringrequired
Your API key
action
stringrequired
status
orders
stringrequired
Order IDs, comma-separated (up to 100)
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=status \
  -d orders=23501,23502
Response
{
  "23501": { "charge": "9900", "start_count": "3572", "status": "Completed", "remains": "0", "currency": "UZS" },
  "23502": { "error": "Incorrect order ID" }
}
POSTaction=refill

Refill drops on services with a guarantee.

Parameters

key
stringrequired
Your API key
action
stringrequired
refill
order
integerrequired
Order ID
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=refill \
  -d order=23501
Response
{ "refill": "1" }
POSTaction=refill_status

Refill status

By the ID returned from refill.

Parameters

key
stringrequired
Your API key
action
stringrequired
refill_status
refill
stringrequired
Refill ID
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=refill_status \
  -d refill=1
Response
{ "status": "Completed" }
POSTaction=cancel

Cancel a number that hasn’t received a code (funds are refunded).

Parameters

key
stringrequired
Your API key
action
stringrequired
cancel
orders
stringrequired
Order IDs, comma-separated (up to 100)
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=cancel \
  -d orders=23510
Response
[
  { "order": 23510, "cancel": 1 },
  { "order": 9, "cancel": { "error": "Incorrect order ID" } }
]
POSTaction=balance

Your current balance.

Parameters

key
stringrequired
Your API key
action
stringrequired
balance
curl -X POST https://foydaads.uz/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance
Response
{ "balance": "100840.5", "currency": "UZS" }

Services and IDs

Live services on the site — pass this ID as service in add. Price: per 1000 for boosting, per unit for everything else.

IDNamePriceMin – max
…

Order statuses

Pending
Accepted, queued
Processing
Sent to the provider / number awaiting SMS
In progress
Running
Completed
Done
Partial
Partially done — the remains part was refunded
Canceled
Canceled — refunded to balance

Errors

Errors come back as HTTP 200 with {"error": "…"} (like standard SMM panels). Messages are in English — match on them.

Invalid API key
Missing or wrong key
Incorrect request
Unknown action or malformed request
Incorrect service ID
No such active service
Incorrect quantity
Quantity is not a number
Incorrect order ID
Order not found or not yours
Not enough funds on balance
Insufficient balance
Account is blocked
Account is blocked
API is temporarily disabled
API is temporarily disabled
Too many requests
Limit: 600 requests per minute per key