Virtual Numbers — Buy a number
GET/POST
https://api.yoozseen.com/api/v1
Charge your balance and receive a Telegram number. The response includes an order_id — that is your token: use it with getCode to read the SMS. Numbers are billed once, at purchase; if the provider can't supply a number you are refunded automatically.
Request
Query parameters
NameDefinition
key *Your Api Key
action *getNumber
country_code *country code from the country list (e.g. uz)
* - mandatory parameter
Request example
1
2
3
4
5
6
7
curl --location 'https://api.yoozseen.com/api/v1/' \
--header 'Content-Type: application/json' \
--data '{
"key": "xxxxxxxxx",
"action": "getNumber",
"country_code": "uz"
}'Response
* Meaning and usage of each parameter
NameDescription
status ok, waiting, or error
message_error error description
order_id your order id — the token used to fetch the code
number the purchased phone number
country_code ISO country code
price price in dollars
currency currency type
Response example
1
2
3
4
5
6
7
8
{
"status": "ok",
"order_id": 1500123,
"number": "+998901234567",
"country_code": "uz",
"price": 0.5,
"currency": "dollar"
}