Getting started

All requests must go to http://api1.$5sim.net/stubs/handler_api.php

For compatibility with existing software, where there is no our service, but there is our API

Ask the developer to add our service, we have referral payments for each order

For Windows

Add the line 88.99.223.62 domain in the file C:\Windows\System32\drivers\etc\hosts, replace domain with the desired domain that is used in the software

For Linux

Add the line 88.99.223.62 domain in the file /etc/hosts, replace domain with the desired domain that is used in the software

If the software does not work

Download the root certificate and install it:

Windows

Open Chrome
Open Settings
Select Manage Certificates
Select Trusted Root Certificate Authorities
Import — 5sim_rootCA.crt

Linux

sudo mkdir /usr/share/ca-certificates/extra

sudo cp 5sim_rootCA.crt /usr/share/ca-certificates/extra/5sim_rootCA.crt

Numbers

Request for the number of available numbers

curl "http://api1.5sim.net/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country"
    

import requests

api_key = 'Your token'
country = 0

params = (
    ('api_key', api_key),
    ('country', country),
    ('action', 'getNumbersStatus'),
)

response = requests.get(
    'http://api1.5sim.net/stubs/handler_api.php',
    params=params,
)
    

<?php

$api_key = 'Your token';
$country = 0;
$action = 'getNumbersStatus';

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://api1.5sim.net/stubs/handler_api.php?api_key=' . $api_key . '&country=' . $country . '&action=' . $action);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
    

{
    "at_0": "330",
    "fb_0": "330",
    "gm_0": "323",
    "go_0": "323",
    "ig_0": "326",
    "mb_0": "330",
    "mm_0": "330",
    "ok_0": "330",
    "or_0": "315",
    "ot_0": "315",
    "qw_0": "327",
    "tg_0": "329",
    "tw_0": "330",
    "vi_0": "330",
    "vk_0": "292",
    "vr_0": "330",
    "wa_0": "330",
    "wb_0": "328",
    "we_0": "330",
    "ya_0": "203",
    "ym_0": "13"
}
    

GET / POST - http://api1.$5sim.net/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country

Returns the number of available numbers

Request parameters

Name	Type	Required	Description
api_key	string	Yes	API Key
country	number / string	No	Country number / Country name

List of available countries

Response

Name	Type	Description
serviceName_{0/1}	string	The name of the service before the dash, after the designation of whether to enable redirection. 0 - do not enable. 1 - enable
total	string	Number of available numbers

Buy number

By receiving the number via the API, you confirm your agreement with the project rules

curl "http://api1.5sim.net/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&forward=$forward&operator=$operator&country=$country"
    

import requests

api_key = 'Your token'
country = 0
service = 'hn'
forward = 0
operator = 'vodaphone'

params = (
    ('api_key', api_key),
    ('country', country),
    ('action', 'getNumber'),
    ('service', service),
    ('forward', forward),
    ('operator', operator),
)

response = requests.get(
    'http://api1.5sim.net/stubs/handler_api.php',
    params=params,
)
    

<?php

$api_key = 'Your token';
$country = 0;
$action = 'getNumber';
$service = 'hn';
$forward = 0;
$operator = 'vodaphone';

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://api1.5sim.net/stubs/handler_api.php?api_key=' . $api_key . '&country=' . $country . '&action=' . $action . '&service=' . $service . '&forward=' . $forward . '&operator=' . $operator);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
    

GET / POST - http://api1.$5sim.net/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&forward=$forward&operator=$operator&country=$country

Orders a phone number for a specific service

Request parameters

Name	Type	Required	Description
api_key	string	Yes	API Key
service	string	Yes	Ordering service
forward	number	No	Enabling redirection. 0 (do not execute), 1 - (execute). The default value is 0
operator	string	No	The name of the operator. Accepted values: three, ee, any, where any is any operator. Optional parameter, default is any
country	number / string	No	Country number / Country name

List of available services

List of available countries

List of available operators

Response

ACCESS_NUMBER: $id:$number - number issued ($id - id of operation, $number - phone number)

NO_NUMBERS - no numbers

NO_BALANCE - not enougth balance

BAD_ACTION - incorrect action

BAD_SERVICE - incorrect product

BAD_KEY - incorrect API key

ERROR_SQL - SQL server error

Set status

curl "http://api1.5sim.net/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward"
    

import requests

api_key = 'Your token'
id = 1
status = 1
forward = 0

params = (
    ('api_key', api_key),
    ('id', id),
    ('action', 'setStatus'),
    ('status', status),
    ('forward', forward),
)

response = requests.get(
    'http://api1.5sim.net/stubs/handler_api.php',
    params=params,
)
    

<?php

$api_key = 'Your token';
$action = 'setStatus';
$id = 1;
$forward = 0;
$status = 1;

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://api1.5sim.net/stubs/handler_api.php?api_key=' . $api_key . '&id=' . $id . '&action=' . $action . '&forward=' . $forward . '&status=' . $status);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
    

GET / POST - http://api1.$5sim.net/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward

Set activation status of the number

Request parameters

Name	Type	Required	Description
api_key	string	Yes	API Key
id	string	Yes	Activation ID
forward	number	Yes / No	The phone number to be forwarded to. Required only if the forward=1 parameter was passed in getNumber
status	string	No	Activation status

Possible activation statuses:

-1 - cancel activation
1 - inform about the availability of the number (sms sent to the number)
3 - request another code (free of charge)
6 - complete activation(if the status was "code received" - marks successful and completes, if it was "preparation" - deletes and places an error, if the status was "waiting for a repeat" - puts the activation in waiting for SMS)
8 - notify that the number is used and cancel the activation

Response

ACCESS_READY - number ready confirmed

ACCESS_RETRY_GET - wait new sms

ACCESS_ACTIVATION - order finished

ACCESS_CANCEL - order cancelled

ERROR_SQL - SQL server error

NO_ACTIVATION - order does not exists

BAD_SERVICE - incorrect product

BAD_STATUS - incorrect status

BAD_KEY - incorrect API key

BAD_ACTION - incorrect action

Get order status

curl "http://api1.5sim.net/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id"
    

import requests

api_key = 'Your token'
id = 1

params = (
    ('api_key', api_key),
    ('id', id),
    ('action', 'getStatus'),
)

response = requests.get(
    'http://api1.5sim.net/stubs/handler_api.php',
    params=params,
)
    

<?php

$api_key = 'Your token';
$action = 'getStatus';
$id = 1;

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://api1.5sim.net/stubs/handler_api.php?api_key=' . $api_key . '&id=' . $id . '&action=' . $action);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
    

GET / POST - http://api1.$5sim.net/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

Return order status

Request parameters

Name	Type	Required	Description
api_key	string	Yes	API Key
id	string	Yes	Order ID

Response

STATUS_WAIT_CODE

STATUS_CANCEL

STATUS_WAIT_RETRY

STATUS_WAIT_RESEND

STATUS_OK

NO_ACTIVATION

ERROR_SQL - SQL server error

BAD_KEY - incorrect API key

BAD_ACTION - incorrect action

Prices

Request for prices

curl "http://api1.5sim.net/stubs/handler_api.php?api_key=$apikey&action=getPrices"
    

import requests

api_key = 'Your token'

params = (
    ('api_key', api_key),
    ('action', 'getPrices'),
)

response = requests.get(
    'http://api1.5sim.net/stubs/handler_api.php',
    params=params,
)
    

<?php

$api_key = 'Your token';
$action = 'getPrices';

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://api1.5sim.net/stubs/handler_api.php?api_key=' . $api_key . '&action=' . $action);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
    

{
    "england": {
        "telegram": {
            "vodaphone": {
                "cost": 8,
                "count": 0
            },
            "matrix": {
                "cost": 8,
                "count": 0
            },
            "virtual4": {
                "cost": 8,
                "count": 0
            },
            "virtual15": {
                "cost": 8,
                "count": 0
            },
            "virtual40": {
                "cost": 8,
                "count": 0
            }
        }
    }
}
    

GET / POST - http://api1.$5sim.net/stubs/handler_api.php?api_key=$apikey&action=getPrices

Returns product prices

Request parameters

Name	Type	Required	Description
api_key	string	Yes	API Key

Response

BAD_ACTION - incorrect action

BAD_KEY - incorrect API key

ERROR_SQL - SQL server error

Request prices by country

curl "http://api1.5sim.net/stubs/handler_api.php?api_key=$apikey&action=getPrices&country=england"
    

import requests

api_key = 'Your token'
country = 'england'

params = (
    ('api_key', api_key),
    ('country', country),
    ('action', 'getPrices'),
)

response = requests.get(
    'http://api1.5sim.net/stubs/handler_api.php',
    params=params,
)
    

<?php

$api_key = 'Your token';
$country = 'england';
$action = 'getPrices';

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://api1.5sim.net/stubs/handler_api.php?api_key=' . $api_key . '&country=' . $country . '&action=' . $action);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
    

{
    "england": {
        "1688": {
            "vodaphone": {
                "cost": 4,
                "count": 1260
            },
            "lycamobile": {
                "cost": 4,
                "count": 935
            },
            "matrix": {
                "cost": 4,
                "count": 0
            }
        }
    }
}
    

GET / POST - http://api1.$5sim.net/stubs/handler_api.php?api_key=$apikey&action=getPrices&country=england

Returns product prices by country

Request parameters

Name	Type	Required	Description
api_key	string	Yes	API Key
country	number / string	Yes	Country number / Country name

List of available countries

Response

BAD_ACTION - incorrect action

BAD_KEY - incorrect API key

ERROR_SQL - SQL server error

Request for a price for a product

curl "http://api1.5sim.net/stubs/handler_api.php?api_key=$apikey&action=getPrices&service=telegram"
    

import requests

api_key = 'Your token'
service = 'telegram'

params = (
    ('api_key', api_key),
    ('action', 'getPrices'),
    ('service', service),
)

response = requests.get(
    'http://api1.5sim.net/stubs/handler_api.php',
    params=params,
)
    

<?php

$api_key = 'Your token';
$action = 'getPrices';
$service = 'telegram';

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://api1.5sim.net/stubs/handler_api.php?api_key=' . $api_key . '&action=' . $action . '&service=' . $service);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
    

{
    "telegram": {
        "afghanistan": {
            "virtual18": {
                "cost": 4,
                "count": 1260
            },
            "virtual23": {
                "cost": 4,
                "count": 935
            },
            "virtual4": {
                "cost": 4,
                "count": 0
            }
        }
    }
}
    

GET / POST - http://api1.$5sim.net/stubs/handler_api.php?api_key=$apikey&action=getPrices&service=telegram

Returns prices for a specific product

Request parameters

Name	Type	Required	Description
api_key	string	Yes	API Key
service	string	Yes	Service name

List of available services

Response

BAD_ACTION - incorrect action

BAD_SERVICE - incorrect product

BAD_KEY - incorrect API key

ERROR_SQL - SQL server error

Request price by country and product

curl "http://api1.5sim.net/stubs/handler_api.php?api_key=$apikey&action=getPrices&country=england&service=telegram"
    

import requests

api_key = 'Your token'
country = 'england'
service = 'telegram'

params = (
    ('api_key', api_key),
    ('country', country),
    ('service', service),
    ('action', 'getPrices'),
)

response = requests.get(
    'http://api1.5sim.net/stubs/handler_api.php',
    params=params,
)
    

<?php

$api_key = 'Your token';
$action = 'getPrices';
$country = 'england';
$service = 'telegram';

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://api1.5sim.net/stubs/handler_api.php?api_key=' . $api_key . '&country=' . $country . '&action=' . $action . '&service=' . $service);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
    

{
    "england": {
        "telegram": {
            "vodaphone": {
                "cost": 8,
                "count": 0
            },
            "matrix": {
                "cost": 8,
                "count": 0
            },
            "virtual26": {
                "cost": 8,
                "count": 0
            },
            "virtual4": {
                "cost": 8,
                "count": 0
            },
            "virtual56": {
                "cost": 8,
                "count": 0
            },
            "virtual15": {
                "cost": 8,
                "count": 0
            },
            "virtual40": {
                "cost": 8,
                "count": 0
            }
        }
    }
}
    

GET / POST - http://api1.5sim.net/stubs/handler_api.php?api_key=$apikey&action=getPrices&country=england&service=telegram

Returns product prices by country and specific product

Request parameters

Name	Type	Required	Description
api_key	string	Yes	API-key
service	string	Yes	Service name
country	number / string	Yes	Country number / Country name

List of available services

List of available countries

Response

BAD_ACTION - incorrect action

BAD_SERVICE - incorrect product

BAD_KEY - incorrect API key

ERROR_SQL - SQL server error

Balance

Balance request

curl "http://api1.5sim.net/stubs/handler_api.php?api_key=$api_key&action=getBalance"
    

import requests

api_key = 'Your token'

params = (
    ('api_key', api_key),
    ('action', 'getBalance'),
)

response = requests.get(
    'http://api1.5sim.net/stubs/handler_api.php',
    params=params,
)
    

<?php

$api_key = 'Your token';
$action = 'getBalance';

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'http://api1.5sim.net/stubs/handler_api.php?api_key=' . $api_key . '&action=' . $action);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
    

GET / POST - http://api1.$5sim.net/stubs/handler_api.php?api_key=$api_key&action=getBalance

Returns user balance

Request parameters

Name	Type	Required	Description
api_key	string	Yes	API Key

Response

ACCESS_BALANCE:$balance (where $balance - balance on the account)

BAD_KEY - incorrect API key

ERROR_SQL - SQL server error

Countries

Available countries

Country	Deprecated API1
Kazakhstan	2
China	3
Philippines	4
Indonesia	6
Malaysia	7
Kenya	8
Tanzania	9
Vietnam	10
Kyrgyzstan	11
USA	12
Israel	13
Hong Kong	14
Poland	15
England	16
Madagascar	17
Congo	18
Nigeria	19
Macau	20
Egypt	21
India	22
Ireland	23
Laos	25
Haiti	26
Ivory Coast	27
Gambia	28
Serbia	29
South Africa	31
Romania	32
Colombia	33
Estonia	34
Azerbaijan	35
Canada	36
Morocco	37
Ghana	38
Argentina	39
Uzbekistan	40
Cameroon	41
Chad	42
Germany	43
Lithuania	44
Croatia	45
Sweden	46
Netherlands	48
Latvia	49
Austria	50
Belarus	51
Thailand	52
Saudi Arabia	53
Mexico	54
Taiwan	55
Spain	56
Algeria	58
Slovenia	59
Bangladesh	60
Senegal	61
Czechia	63
Sri Lanka	64
Peru	65
Pakistan	66
New Zealand	67
Venezuela	70
Ethiopia	71
Mongolia	72
Brazil	73
Afghanistan	74
Uganda	75
Angola	76
Cyprus	77
France	78
Papua New Guinea	79
Mozambique	80
Nepal	81
Belgium	82
Bulgaria	83
Hungary	84
Moldova	85
Italy	86
Paraguay	87
Honduras	88
Tunisia	89
Nicaragua	90
East Timor	91
Bolivia	92
Costa Rica	93
Guatemala	94
Puertorico	97
Togo	99
Kuwait	100
Salvador	101
Jamaica	103
Trinidad and Tobago	104
Ecuador	105
Swaziland	106
Oman	107
Bosnia and Herzegovina	108
Dominican Republic	109
Panama	112
Mauritania	114
Sierra Leone	115
Jordan	116
Portugal	117
Barbados	118
Burundi	119
Benin	120
Botswana	123
Georgia	128
Greece	129
Guinea-Bissau	130
Guyana	131
Saint Kitts and Nevis	134
Liberia	135
Lesotho	136
Malawi	137
Namibia	138
Rwanda	140
Slovakia	141
Suriname	142
Tajikistan	143
Bahrain	145
Reunion	146
Zambia	147
Armenia	148
Burkina Faso	152
Gabon	154
Albania	155
Uruguay	156
Mauritius	157
Bhutan	158
Maldives	159
Turkmenistan	161
French Guiana	162
Finland	163
Saint Lucia	164
Luxembourg	165
Saint Vincent and the Grenadines	166
Antigua and Barbuda	169
Norway	174
Australia	175
Aruba	179
North Macedonia	183
New Caledonia	185
Cape Verde	186

You can also use the full name of the country:

Country	API 5SIM

Services

Available services

Service	Deprecated API1
1688	hn
1xBet	wj
32red	qi
888casino	ll
99 App	ki
Adidas	an
Agroinform	qu
Airbnb	uk
Airtel	zl
Airtel	wf
Aitu	jj
Algida	lp
Alibaba	ab
AliExpress	hx
AliExpress	al
Amasia	yo
Amazon	am
AOL	pm
Apple	wx
Auchan	st
Avito	av
Avon	ff
B4U Cabs	bu
Baidu	li
Bigo Live	bl
Bisu	el
Bitclout	lt
BlaBlaCar	ua
Blizzard	bz
Blued	qn
Bolt	tx
Brand20ua	vo
Burger King	ip
Bykea	iu
Cafebazaar	uo
Careem	ls
Carousell	gj
CDKeys	pq
Citaprevia	si
Citymobil	yf
Cliqq	fe
Clubhouse	et
Craigslist	wc
Dbrua	tj
Deliveroo	zk
Delivery	dt
Dent	zz
DiDi	xk
Digikala	zv
Discord	ds
Disneyhotstar	ud
Divar	dw
Dodopizza	sd
Domino's Pizza	dz
Dostavista	sv
DouYu	ak
Dream11	ve
Drom	hz
eBay	dh
Ebikegewinnspiel	le
Eneba	uf
Ezbuy	db
Faberlic	rm
Facebook	fb
Fiqsy	ug
Fiverr	cn
Foodpanda	nz
foody	kw
Gamearena	wn
Gamekit	pa
Gamer	ed
Getir	ul
Gett	gt
Gg	qe
Gittigidiyor	nk
Globus	hm
Glovo	aq
Google/YouTube	go
Grab Taxi	jg
Grindr	yw
Hamrahaval	rp
happn	df
Haraj	au
Hepsiburada	gx
Hezzl	ss
Hily	rt
Hopi	jl
Hqtrivia	kp
Humble Bundle	un
Humta	gv
Huya	pp
Icq	iq
iFood	pd
Immowelt	ib
Imo	im
Inbox.lv	iv
inDrive	rl
Instagram/Threads	ig
Iqos	il
Ivi	jc
JD	za
Jkf	hr
Justdating	pu
Justdial	jdl
KakaoTalk	kt
Keybase	bf
Kufarby	kb
Kvartplata	yb
Kwai	vp
Lazada	dl
Lenta	rd
Line	me
LinkedIn	tn
Livescore	eu
Magnit	mg
Magnolia	up
Mamba/Wamba	fd
McDonald's	ry
Mega	qr
Mercado	cq
Michat	mc
Microsoft	mm
Miratorg	op
Mobile01	wk
Mosru	ce
Mrgreen	lw
Myfishka	qa
Myglo	ae
Mylove	fy
Mymusictaste	mu
Mzadqatar	jm
Nana	na
Naver	nv
NCsoft	sw
Netflix	nf
Nhseven	nh7
Nifty	px
Nike	ew
Nrjmusicawards	pg
Nttgame	zy
Offerup	zm
Offgamers	uz
Okta	lr
Olacabs	ly
OLX	sn
Onlinerby	ob
Oriflame	qh
Other	ot
Ozon	sg
Paddy Power	cw
Pairs	dk
Payberry	qb
Peoplecom	pe
Perekrestok	pl
Pgbonus	fx
POF	pf
Pokec	pk
Potato	fj
Prajmeriz2020	qc
Premiumone	po
Prom	cm
Protonmail	dp
Protp	rra
Pureplatfrom	lk
Pyromusic	ny
Q12trivia	vf
Qiwiwallet	qw
Quipp	cc
Rediffmail	co
Rsa	cy
Rutube	ui
Samokat	jr
Seosprint	vv
Sheerid	rx
Shopee	ka
Sikayetvar	fs
Skout	wg
Snapchat	fu
Snappfood	ph
Sneakersnstuff	sf
Socios	ia
Sportmaster	yk
Spothit	cd
Ssoidnet	la
Steam	mt
Surveytime	gd
Swvl	tq
Taksheel	ei
Tango	xr
Tantan	ta
Taobao	qd
Telegram	tg
Tencent QQ	qq
Ticketmaster	gp
TikTok/Douyin	lf
Tinder	oi
Touchance	fm
Trendyol	pr
Twitch	hb
Twitter/X	tw
Uber	ub
Ukrnet	hu
Vernyj	nb
Viber	vi
Vitajekspress	bj
WeChat	wb
Weibo	kf
Weststein	th
WhatsApp	wa
Wildberries	uu
Wish	xv
Wmaraci	xl
Wolt	rr
Yaay	vn
Yahoo	mb
Yalla	yl
Yemeksepeti	yi
Youla	ym
Youstar	gb
Zalo	mj
Zoho	zh

You can also use the full name of the service:

Service	API 5SIM

Operators

In order to get a list of operators, you need authorization.