This section provides lists of status codes, supported languages, and time zones that you can use with the SMS API, Voice API, Score API, PhoneID API, and App Verify.

The following information is included here:

Country Codes and Dialing Codes

The following is a list of numeric country codes and dialing codes, which are used for the numbering:country_code, country:name, and country:iso2 parameters in a PhoneID Standard response.

NOTE:

Netherlands Antilles: Bonaire, Curacao, Saba, St. Eustatius, and St. Maarten. St. Maarten can use 1 or 599.

Country Name	Country Name Abbreviation	Country Code
Afghanistan	AF	93
Albania	AL	355
Algeria	DZ	213
American Samoa	AS	1
Andorra	AD	376
Angola	AO	244
Anguilla	AI	1
Antigua and Barbuda	AG	1
Argentina	AR	54
Armenia	AM	374
Aruba	AW	297
Ascension	AC	247
Australia	AU	61
Australian External Territories	AX	672
Austria	AT	43
Azerbaijan	AZ	994
Bahamas	BS	1
Bahrain	BH	973
Bangladesh	BD	880
Barbados	BB	1
Belarus	BY	375
Belgium	BE	32
Belize	BZ	501
Benin	BJ	229
Bermuda	BM	1
Bhutan	BT	975
Bolivia	BO	591
Bosnia and Herzegovina	BA	387
Botswana	BW	267
Brazil	BR	55
British Virgin Islans	VG	1
Brunei Darussalam	BN	673
Bulgaria	BG	359
Burkina Faso	BF	226
Burundi	BI	257
Cambodia	KH	855
Cameroon	CM	237
Canada	CA	1
Cape Verde	CV	238
Cayman Islands	KY	1
Central African Republic	CF	236
Chad	TD	235
Chile	CL	56
China	CN	86
Colombia	CO	57
Comoros	KM	269
Congo	CG	242
Cook Islands	CK	682
Costa Rica	CR	506
Cote d’Ivorie	CI	225
Croatia	HR	385
Cuba	CU	53
Cyprus	CY	357
Czech Republic	CZ	420
Diego Garcia	DG	246
Djibouti	DJ	253
Dominica	DM	1
Dominican Republic	DO	1
East Timor	TL	670
Ecuador	EC	593
Egypt	EG	20
El Salvador	SV	503
Equatorial Guinea	GQ	240
Eritrea	ER	291
Estonia	EE	372
Ethiopia	ET	251
Falkland Islands	FK	500
Faroe Islands	FO	298
Fiji	FJ	679
Finland	FI	358
France	FR	33
French Guiana	GF	594
French Polynesia	PF	689
Gabon	GA	241
Gambia	GM	220
Georgia	GE	995
Germany	DE	49
Ghana	GH	233
Gibraltar	GI	350
Greece	GR	30
Greenland	GL	299
Grenada	GD	1
Guadeloupe	GP	590
Guam	GU	1
Guatemala	GT	502
Guinea	GN	224
Guinea-Bissau	GW	245
Guyana	GY	592
Haiti	HT	509
Honduras	HN	504
Hong Kong	HK	852
Hungary	HU	36
Iceland	IS	354
India	IN	91
Indonesia	ID	62
Iran	IR	98
Iraq	IQ	964
Ireland	IE	353
Israel	IL	972
Italy	IT	39
Jamaica	JM	1
Japan	JP	81
Jordan	JO	962
Kazakhstan	KZ	7
Kenya	KE	254
Kiribati	KI	686
Kuwait	KW	965
Kyrgyzstan	KG	996
Laos	LA	856
Latvia	LV	371
Lebanon	LB	961
Lesotho	LS	266
Liberia	LR	231
Libya	LY	218
Liechtenstein	LI	423
Lithuania	LT	370
Luxembourg	LU	352
Macao	MO	853
Macedonia	MK	389
Madagascar	MG	261
Malawi	MW	265
Malaysia	MY	60
Maldives	MV	960
Mali	ML	223
Malta	MT	356
Marshall Islands	MH	692
Martinique	MQ	596
Mauritania	MR	222
Mauritius	MU	230
Mexico	MX	52
Micronesia	FM	691
Moldova	MD	373
Monaco	MC	377
Mongolia	MN	976
Montenegro	ME	382
Montserrat	MS	1
Morocco	MA	212
Mozambique	MZ	258
Myanmar	MM	95
Namibia	NA	264
Nauru	NR	674
Nepal	NP	977
Netherlands	NL	31
Netherlands Antilles*	AN	599
New Caledonia	NC	687
New Zealand	NZ	64
Nicaragua	NI	505
Niger	NE	227
Nigeria	NG	234
Niue	NU	683
North Korea	KP	850
Northern Mariana Islands	MP	1
Norway	NO	47
Oman	OM	968
Pakistan	PK	92
Palau	PW	680
Palestine	PS	970
Panama	PA	507
Papau New Guinea	PG	675
Paraguay	PY	595
Peru	PE	51
Phillippines	PH	63
Poland	PL	48
Portugal	PT	351
Puerto Rico	PR	1
Qatar	QA	974
Reunion	RE	262
Romania	RO	40
Russia	RU	7
Rwanda	RW	250
Saint Helena	SH	290
Saint Kitts and Nevis	KN	1
Saint Lucia	LC	1
Saint Pierre and Miquelon	PM	508
Saint Vincent and Grenadines	VC	1
Samoa	WS	685
San Marino	SM	378
Sao Tome and Principe	ST	239
Saudi Arabia	SA	966
Senegal	SN	221
Serbia	RS	381
Seychelles	SC	248
Sierra Leone	SL	232
Singapore	SG	65
Slovakia	SK	421
Slovenia	SI	386
Solomon Islands	SB	677
Somalia	SO	252
South Africa	ZA	27
South Korea	KR	82
Spain	ES	34
Sri Lanka	LK	94
Sudan	SD	249
Suriname	SR	597
Swaziland	SZ	268
Sweden	SE	46
Switzerland	CH	41
Syria	SY	963
Taiwan	TW	886
Tajikistan	TJ	992
Tanzania	TZ	255
Thailand	TH	66
Togo	TG	228
Tokelau	TK	690
Tonga	TO	676
Trinidad and Tobago	TT	1
Tunisia	TN	216
Turkey	TR	90
Turkmenistan	TM	993
Turks and Caicos Islands	TC	1
Tuvalu	TV	688
US Virgin Islands	VI	1
Uganda	UG	256
Ukraine	UA	380
United Arab Emirates	AE	971
United Kingdom	GB	44
United States	US	1
Uruguay	UY	598
Uzbekistan	UZ	998
Vanuatu	VU	678
Vatican City	VA	379
Venezuela	VE	58
Vietnam	VN	84
Wallis and Futuna	WF	681
Yemen	YE	967
Zambia	ZM	260
Zimbabwe	ZW	263

HTTP Codes Mapped to Error Codes

HTTP Code	Error Code	Associated Text String	Product
401	10002	`x-ts-nonce` header value has been used recently	All
401	10003	`x-ts-nonce` header value is either too long or too short	All
401	10004	`Date` or `x-ts-date` header is not within tolerable range
401	10005	`Date` or `x-ts-date` header is not RFC822 compliant	All
401	10006	Invalid `x-ts-auth-method` header	All
401	10007	Missing required `Date` or `x-ts-date` header
401	10008	Invalid Signature.	All
401	10009	Missing required `Authorization` header	All
401	10010	CustomerID Account Suspended	All
401	10011	This product is not enabled for this CustomerID	All
401	10012	This feature is not enabled for this Customer ID	All
401	10013	Invalid Request. CustomerID Account Not Found	All
401	10014	Invalid source IP address	All
401	10015	Invalid customer ID	All
404	10017	CustomerID/ReferenceID not found	All
429	10019	Rate Limit Exceeded	All
429	10020	{product_code} exceeded transaction hard cap. Request denied (This sentence and the following sentence are not part of the associated text string. The available values for `product_code` are ‘Voice API Call’, ‘Messaging’, ‘PhoneID Standard’, and ‘PhoneID Score’.	All
401	10021	This product is not enabled for this country	All
401	10028	Required `Authorization` header is not in the correct format	All
402	10030	Insufficient funds in prepaid wallet.	All
401	10031	Not Allowed Host	All
400	10032	Message blocked by TeleSign	All
400	10033	Unverified `phone_number` requested for trial account.	All
400	10034	Call with declared type blocked in country requested	Voice
401	10035	The requested API host is not allowed for this `customer_id`	All
404	10036	`reference_id` expired.	Messaging, Voice
400	11000	Invalid value for parameter `phone_number`	All
400	11001	Invalid country code for parameter `phone_number`	All
400	11002	Invalid value for parameter `account_id`	Score
400	11003	Invalid value for parameter `account_lifecycle_event`	All
400	11004	Invalid value for parameter `callback_url`	Messaging, Voice
400	11005	Invalid value for parameter `customer_id`	All
400	11006	Invalid value for parameter `device_id`	Score
400	11007	Invalid value for `email_address`	Score
400	11009	Invalid value for parameter `message`	Messaging, Voice
400	11011	Invalid value for parameter `reference_id`	All
400	11017	Invalid value for parameter `message_type`	Messaging, Voice
400	11018	Invalid value for parameter `voice`	Voice
400	12000	Missing required parameter `phone_number`	All
400	12003	Missing required parameter `account_lifecycle_event`	Score
400	12009	Missing required parameter `message`	Messaging, Voice
400	12017	Missing required parameter `message_type`	Messaging, Voice

Phone Number Cleansing Codes

Code	Description	Detail
100	No Changes / Exact	No changes were made to the phone number. The phone number was formatted properly, and no cleansing was required.
101	Changed	The phone number was changed to ensure call completion. For example, extraneous digits were removed, such as 011, or additional digits were added to meet dialing rules.
102	Restricted Number	The phone number entered is a restricted phone number. Phone numbers that are restricted include premium rate numbers, short codes (such as emergency services numbers), satellite phones, etc.
103	No Match	The phone number appears to be formatted correctly, but cannot be matched to any specific area.
104	Invalid	The phone number is not correctly formatted.
105	Partial Match	The phone number length is too long or too short.

Phone Type Codes

Code	Description	Risk	Action	Detail
1	`FIXED_LINE`	Low	Allow	Fixed-line phones include traditional landline phones and VOIP phones that can be traced back to a particular address and cannot be obtained by a user outside the phone number’s designated country. Because these phone numbers are traceable, they are low-risk.
2	`MOBILE`	Medium-Low	Allow	Mobile telephones are provided by companies such as Verizon, Cingular, or Sprint. Users of these phones must sign contracts, making these telephone numbers traceable. These phone numbers are generally low-risk. However, some prepaid mobile phones will be identified as Mobile. Internationally, phones identified as mobile can also include TETRA mobile phones, cordless access systems, proprietary fixed radio access, and fixed cellular systems.
3	`PREPAID` (for prepaid mobile)	Medium-High	Flag	These telephones can be purchased anonymously at department stores. They work like other mobile phones, but their users are not contracted with a mobile phone company. Prepaid mobile phones generally cost between $30 and $100, making them unattractive for most fraudsters, but TeleSign recommends flagging transactions made with this type of telephone due to users’ anonymity. Also, not all prepaid mobile phones will be identified as prepaid; some will be identified as Mobile.
4	`TOLL_FREE`	High	Block	Toll-Free numbers are numbers starting with toll-free area codes, such as (800). Although often used by legitimate users calling from companies, fraudsters can easily obtain toll-free numbers that either forward to a telephone located in another country or toll-free numbers that terminate at an Internet voicemail box. Toll-free numbers always forward to non-toll-free numbers. For this reason, any legitimate user who provides a toll-free number and is asked to provide a non-toll-free number will be able to do so. TeleSign therefore recommends blocking users of toll-free numbers.
5	`VOIP` (non-fixed VOIP)	High	Block	Voice Over Internet Protocol (VOIP) phone numbers are Internet-based telephone numbers. Non-fixed VOIP telephone numbers can easily be obtained by users who are not located in the country associated with the telephone number. They are untraceable and disposable; some can even be obtained for free. This means that a fraudster in Romania could easily obtain a US-based telephone number using a non-fixed VOIP service and receive a call to this number in his or her home in Romania.
6	`PAGER`	High	Block	This phone number rings to a pager. Because pagers cannot receive verification calls, it’s best to block calls to these numbers. These calls are most likely requested by fraudsters who are inputting invalid phone numbers.
7	`PAYPHONE`	High	Block	Calls to a payphone cannot be traced back to any one person; therefore, we recommend blocking verification calls to these numbers.
8	`INVALID`	High	Block	The telephone number entered is not a valid number.
9	`RESTRICTED_PREMIUM` (Restricted Number)	High	Block	The telephone number entered is a restricted number. In the US, restricted numbers include numbers that begin with 0 and numbers with the following area codes: 900, 911, 411. Internationally, the following phone types are restricted: Audiotext, Carrier selection, National rate, Premium rate, Shared cost, Satellite, Short Code
10	`PERSONAL`	Medium-Low	Allow	A “Personal” phone number is a phone number which allows a Subscriber to receive calls at almost any telephone number, including a mobile number. The “Personal” number forwards to another phone number, which is determined by the subscriber. Because the “Personal” number can forward to either a landline or mobile number, it’s impossible to determine what type of phone the subscriber is using. However, because “Personal” phone numbers must be obtained from a phone company, there is little risk of fraud associated with this phone type.
11	`VOICEMAIL`	Medium-High	Block	Voicemail phone numbers will ring directly to a user’s voicemail. Although this phone number was likely purchased through a phone company and may be traceable, it will be impossible to reach the user live at this phone number. In addition, any user providing a voicemail number should also have a valid landline or mobile phone available. Therefore, TeleSign recommends blocking this type of phone.
20	`OTHER`	Medium-High	Block	Phone numbers labeled “Other” are all various types of phones that originate in non-US countries. The following types of phones may be included under the “Other” category: Global title address, Inbound routing code, Videotext, VPN. Because clients should not be requesting calls to these phone types, we recommend blocking verification calls to these numbers. Any phone number entered that falls under the “Other” category was probably either entered incorrectly or was entered by a fraudster testing various phone numbers.

Time Zones

A Time Zone is a region on the Earth’s surface in which clocks share the same time. The globe is divided into 40 time zones, and although they tend to follow the boundaries of countries, every time zone is bounded by two lines of longitude, normally 15° of longitude apart.

The Standard Time Zones are those that are offset from Universal Coordinated Time (UTC) by a whole number of hours (UTC−12 to UTC+14), and there are 24 of them. The remaining 16 time zones are offset by either 30 or 45 minutes.

Some higher latitude countries use Daylight Saving Time for part of the year. Here, clocks are set forward by one hour in the Spring, and then back again in the Fall. Many Land Time Zones are skewed West of the corresponding Nautical Time Zone to create a permanent Daylight Saving Time.

NOTE:

The countries China and India use one time zone throughout the entire country—even though the extent of their territory far exceeds 15° of longitude.

Abbreviation	Name	UTC Offset
ACDT	Australian Central Daylight Time	UTC+10:30
ACST	Australian Central Standard Time	UTC+09:30
ACT	ASEAN Common Time	UTC+08
ADT	Atlantic Daylight Time	UTC-03
AEDT	Australian Eastern Daylight Time	UTC+11
AEST	Australian Eastern Standard Time	UTC+10
AFT	Afghanistan Time	UT+04:30
AKDT	Alaska Daylight Time	UTC-08
AKST	Alaska Standard Time	UTC-09
AMST	Armenia Summer Time	UTC+05
AMT	Armenia Time	UTC+04
ART	Argentina Time	UTC-03
AST	Arab Standard Time (Huwait, Riyadh)	UTC+03
AST	Arabian Standard Time (Abu Dhabi, Muscat)	UTC+04
AST	Arabic Standard Time (Baghdad)	UTC+03
AST	Atlantic STandard Time	UTC+04
AWDT	Australian Western Daylight Time	UTC+09
AWST	Australian Western Standard Time	UTC+08
AZOST	Azores Standard Time	UTC-01
AZT	Azerbaijan Time	UTC+04
BDT	Brunei Time	UTC+08
BIOT	British Indian Ocean Time	UTC+06
BIT	Baker Island Time	UTC-12
BOT	Bolivia Time	UTC-04
BRT	Brasilia Time	UTC-03
BST	Bangladesh Standard Time	UTC+06
BST	British Summer Time (British Standard Time from Feb 1968 to Oct 1971)
BTT	Bhutan Time	UTC+06
CAT	Central Africa Time	UTC+02
CCT	Cocos Islands Time	UTC+06:30
CDT	Central Daylight Time (North America)	UTC-05
CEDT	Central European Daylight Time	UTC+02
CEST	Central European Summer Time (Cf. HAEC)	UTC+02
CET	Central European Time	UTC+01
CHADT	Chatham Daylight Time	UTC+13:45
CHAST	Chatham STandard Time	UTC+12:45
CHOT	Choibalsan	UTC-08
CHST	Chamorro Standard Time	UTC+10
CHUT	Chuuk Time	UTC+10
CIST	Clipperton Island Standard Time	UTC-08
CIT	Central Indonesia Time	UTC+08
CKT	Cook Island Time	UTC-10
CLST	Chile Summer Time	UTC-03
CLT	Chile Standard Time	UTC-04
COST	Colombia Summer Time	UTC-04
COT	Colombia Time	UTC-05
CST	Central Standard Time (North America)	UTC-06
CST	China Standard Time	UTC+08
CST	Central Standard Time (Australia)	UTC+09:30
CST	Central Summer Time (Australia)	UTC+10:30
CST	Cuba Standard Time	UTC-05
CT	China Time	UTC+08
CVT	Cape Verde Time	UTC-01
CWST	Central Western Standard Time (Australia)	UTC+08:45
CXT	Christmas Island Time	UTC+07
DAVT	Davis Time	UTC+07
DDUT	Dumont d’Urville Time	UTC+07
DFT	AIX specific equivalent of Central Eurpoean Time	UTC+01
EASST	Easter Island Standard Summer Time	UTC-05
EAST	Easter Island Standard Time	UTC-06
EAT	East Africa Time	UTC+03
ECT	Eastern Caribbean Time (does not recognize DST)	UTC-04
ECT	Ecuador Time	UTC-05
EDT	Eastern Daylight Time (North America)	UTC-04
EEDT	Eastern European Daylight Time	UTC+03
EEST	Eastern European Summer Time	UTC+03
EET	Eastern European Time	UTC+02
EGST	Eastern Greenland Summer Time	UTC+00
EGT	Eastern Greenland Time	UTC-01
EIT	Eastern Indonesian Time	UTC+09
EST	Eastern Standard Time (North America)	UTC-05
EST	Eastern STandard Time (Australia)	UTC+10
FET	Further-eastern_European_Time	UTC+03
FJT	Fiji Time	UTC+12
FKST	Falkland Islands Summer Time	UTC-03
FKT	Falkland Islands Time	UTC-04
FNT	Fernando de Noronha Time	UTC-02
GALT	Galapagos Time	UTC-06
GAMT	Gambier Islands	UTC-09
GET	Georgia Standard Time	UTC+04
GFT	French Guiana Time	UTC-03
GILT	Gilbert Island Time	UTC+12
GIT	Gambier Island Time	UTC-09
GMT	Greenwich Mean Time	UTC
GST	Gulf Standard Time	UTC+04
GYT	Guyana Time	UTC-04
HADT	Hawaii-Aleutian Daylight Time	UTC-09
HAEC	Heure Avancée d’Europe Centrale francised name for CEST	UTC+02
HAST	Hawaii-Aleutian Standard Time	UTC-10
HKT	Hong Kong Time	UTC+08
HMT	Heard and McDonalds Islands Time	UTC+05
HOVT	Khovd Time	UTC+07
HST	Hawaii Standard Time	UTC-10
ICT	Indochina Time	UTC+07
IDT	Israel Daylight Time	UTC+08
IOT	Indian ocean Time	UTC+03
IRDT	Iran Daylight Time	UTC+08
IRKT	Irkutsk Time	UTC+08
IRST	Iran Standard Time	UTC+03:30
IST	Indian Standard Time	UTC+05:30
IST	Irish Summer Time	UTC+01
IST	Israel Standard Time	UTC+02
JST	Japan Standard Time	UTC+09
KGT	Kyrgyzstan Time	UTC+07
KOST	Kosrae Time	UTC+07
KRAT	Krasnoyarsk Time	UTC+07
KST	Korea Standard Time	UTC+09
LHST	Lord Howe Standard Time	UTC+10:30
LHST	Lord Howe Summer Time	UTC+11
LINT	Line Islands Time	UTC+14
MAGT	Magadan Time	UTC+12
MART	Marquesas Islands Time	UTC-09:30
MAWT	Mawson Station Time	UTC+05
MDT	Mountain Daylight Time (North America)	UTC-06
MET	Middle European Time Same zone as CET	UTC+01
MEST	Middle European Saving Time Same zone as CEST	UTC+02
MHT	Marshall Islands	UTC+12
MIST	Macquarie Island Station Time	UTC+11
MIT	Marquesas Islands Time	UTC-09:30
MMT	Myanmar Time	UTC+06:30
MSK	Moscow Time	UTC+04
MST	Malaysia Standard Time	UTC+08
MUT	Mauritius Time	UTC+04
MVT	Maldives Time	UTC+05
MYT	Malaysia Time	UTC+08
NCT	New Caledonia Time	UTC+11
NDT	Newfoundland Daylight Time	UTC-02:30
NFT	Norfolk Time[1]	UTC+11:30
NPT	Nepal Time	UTC+05:45
NST	Newfoundland Time	UTC-03:30
NT	Newfoundland Time	UTC-03:30
NUT	Niue Time	UTC-11:30
NZDT	New Zealand Daylight Time	UTC+13
NZST	New Zealand Standard Time	UTC+12
OMST	Omsk Time	UTC+06
ORAT	Oral Time	UTC-05
PDT	Pacific Daylight Time (North America)	UTC-07
PET	Peru Time	UTC-05
PETT	Kamchatka Time	UTC+12
PGT	Papua New Guinea Time	UTC+10
PHOT	Phoenix Island Time	UTC+13
PHT	Philippine Time	UTC+08
PKT	Pakistan Standard Time	UTC+05
PMDT	Saint Pierre and Miquelon Daylight Time	UTC+08
PMST	Saint Pierre and Miquelon Standard Time	UTC+08
PONT	Pohnpei Standard Time	UTC+11
PST	Pacific Standard Time (North America)	UTC-08
PST	Philippine Standard Time	UTC+08
RET	Reunion Time	UTC+04
ROTT	Rothera Research Station Time	UTC-03
SAKT	Sakhalin Island TIme	UTC+11
SAMT	Samara Time	UTC+04
SAST	South African Standard Time	UTC+02
SBT	Solomon Islands Time	UTC+11
SCT	Seychelles Time	UTC+04
SGT	Singapore Time	UTC+08
SLT	Sri Lanka Time	UTC+05:30
SRT	Suriname Time	UTC-03
SST	Samoa Standard Time	UTC-11
SYOT	Showa Station Time	UTC+03
TAHT	Tahiti Time	UTC-10
THA	Thailand Standard Time	UTC+07
TFT	Indian/Kerguelen	UTC+05
TJT	Tajikistan Time	UTC+05
TKT	Tokelau Time	UTC+14
TLT	Timor Leste Time	UTC+09
TMT	Turkmenistan Time	UTC+05
TOT	Tonga Time	UTC+13
TVT	Tuvalu Time	UTC+12
UCT	Coordinated Universal Time	UTC
ULAT	Ulaanbaatar Time	UTC+08
UTC	Coordinated Universal Time	UTC
UYST	Uruguay Summer Time	UTC-02
UYT Uruguay Standard Time	UTC-03
UZT	Uzbekistan Time	UTC+05
VET	Venezuelan Standard Time	UTC-04:30
VLAT	Vladivostok Time	UTC+10
VOLT	Volgograd Time	UTC+04
VOST	Vostok Station Time	UTC+06
VUT	Vanuatu Time	UTC+11
WAKT	Wake Island Time	UTC+12
WAST	West Africa Summer Time	UTC+02
WAT	West Africa Time	UTC+01
WEDT	Western European Daylight Time	UTC+01
WEST	Western European Summer Time	UTC+01
WET	Western European Time	UTC
WST	Western Standard Time	UTC+08
YAKT	Yakutsk Time	UTC+09
YEKT	Yekaterinburg Time	UTC+05