API reference · v2 compat + v3 native

Boring docs for production APIs.

Endpoints you can copy-paste. Auth via key only — no OAuth dance. Interactive OpenAPI browser inside the dashboard once you have a key.

Authentication

Every request carries a single key field. Generate one in the dashboard, rotate whenever. No expiry unless you set one.

Rate limits

60 req/min on read endpoints, 30 req/min on writes. Above Platinum tier those double — message support for higher ceilings.

Core endpoints (JAP-compatible)
POST/api/v2action =services

List available services with current rates, min/max, and refill policy.

POST/api/v2action =add

Create an order. Idempotency-Key header supported on v3.

POST/api/v2action =status

Live status, start count, delivered count, remaining, ETA.

POST/api/v2action =refill

Request a free refill inside the 90-day window on eligible subscriber orders.

Webhooks, in one paragraph.

Configure a URL in the dashboard. We POST a JSON body on status changes:in_progress,completed,partial,canceled. Signed with HMAC-SHA256. We retry with exponential backoff up to 24h if your endpoint 5xxs.

OpenAPI browser lives in the dashboard.

Full spec, "Try it out" against your own key, request/response examples for every endpoint. Sign in to see it.

Open the spec
Telegram SMM API Docs — Reseller API Reference | Telegram.Software