What problem does the Telegram Premium API solve?
For projects that sell or gift Telegram Premium, the main challenge is fulfilling orders quickly and without mistakes. Manually choosing the duration, comparing prices and sending payment takes both time and attention.
The Premium API combines these steps into one flow: the username is received, the duration is chosen, the current price is fetched, and payment is taken automatically from the project balance.
Supported durations
The API works with 3-, 6- and 12-month Premium gift options, covering the packages resellers and bots need most.
Prices can be fetched in advance through a separate endpoint, so it's easy to show the customer the exact cost of each package before ordering.
- 3-month Telegram Premium
- 6-month Telegram Premium
- 12-month Telegram Premium
- Automatic ordering via REST JSON
Order flow and endpoints
The developer first gets an API key in the project and sets up the balance. Then the bot or backend sends requests to Fragment-API.uz endpoints with the X-API-Key header.
/api/v1/premium/pricing returns the prices of available packages, and /api/v1/premium/buy fulfils the order by username and duration. /api/v1/getInfo is used to check the recipient in advance.
All responses share the same structure — ok, message, code and result — so handling success and error cases is straightforward.
Security and control
Each project is separated by its own API key, so different customers' flows never mix. The dashboard shows the balance, number of orders and spending statistics.
Private API endpoints are closed to search crawlers, while the public docs and article pages remain open for indexing.
Getting started with the integration
The shortest path: sign up, create a project, get the API key and set up the balance. Then connect the pricing and order endpoints one after another.
Request, response and cURL samples are ready in the /api docs, so you can test your first order within minutes.
Frequently asked questions
Which durations does the Telegram Premium API support?
The API works with 3-, 6- and 12-month Telegram Premium packages.
Can I get Premium prices in advance?
Yes. The Premium pricing endpoint returns current prices for the available packages, so you can show the customer the price in advance.
How does payment work?
Payment is automatically deducted from the project balance. There must be enough funds on the balance for the order to be fulfilled.
Where is the order status shown?
Orders are written to the project dashboard statistics, and the API response returns a success or error code.
Can I check the user in advance?
Yes. The getInfo endpoint lets you check that a recipient with that username exists before ordering.