Codes, Languages, and Time Zones

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.

Country Codes and Dialing Codes

The following is a list of numeric country codes and dialing codes, which are used in several different response properties returned by TeleSign's self-service APIs.

📘

NOTE:

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

Country NameCountry Name AbbreviationCountry Code
AfghanistanAF93
AlbaniaAL355
AlgeriaDZ213
American SamoaAS1
AndorraAD376
AngolaAO244
AnguillaAI1
Antigua and BarbudaAG1
ArgentinaAR54
ArmeniaAM374
ArubaAW297
AscensionAC247
AustraliaAU61
Australian External TerritoriesAX672
AustriaAT43
AzerbaijanAZ994
BahamasBS1
BahrainBH973
BangladeshBD880
BarbadosBB1
BelarusBY375
BelgiumBE32
BelizeBZ501
BeninBJ229
BermudaBM1
BhutanBT975
BoliviaBO591
Bosnia and HerzegovinaBA387
BotswanaBW267
BrazilBR55
British Virgin IslansVG1
Brunei DarussalamBN673
BulgariaBG359
Burkina FasoBF226
BurundiBI257
CambodiaKH855
CameroonCM237
CanadaCA1
Cape VerdeCV238
Cayman IslandsKY1
Central African RepublicCF236
ChadTD235
ChileCL56
ChinaCN86
ColombiaCO57
ComorosKM269
CongoCG242
Cook IslandsCK682
Costa RicaCR506
Cote d'IvorieCI225
CroatiaHR385
CubaCU53
CyprusCY357
Czech RepublicCZ420
Diego GarciaDG246
DjiboutiDJ253
DominicaDM1
Dominican RepublicDO1
East TimorTL670
EcuadorEC593
EgyptEG20
El SalvadorSV503
Equatorial GuineaGQ240
EritreaER291
EstoniaEE372
EthiopiaET251
Falkland IslandsFK500
Faroe IslandsFO298
FijiFJ679
FinlandFI358
FranceFR33
French GuianaGF594
French PolynesiaPF689
GabonGA241
GambiaGM220
GeorgiaGE995
GermanyDE49
GhanaGH233
GibraltarGI350
GreeceGR30
GreenlandGL299
GrenadaGD1
GuadeloupeGP590
GuamGU1
GuatemalaGT502
GuineaGN224
Guinea-BissauGW245
GuyanaGY592
HaitiHT509
HondurasHN504
Hong KongHK852
HungaryHU36
IcelandIS354
IndiaIN91
IndonesiaID62
IranIR98
IraqIQ964
IrelandIE353
IsraelIL972
ItalyIT39
JamaicaJM1
JapanJP81
JordanJO962
KazakhstanKZ7
KenyaKE254
KiribatiKI686
KuwaitKW965
KyrgyzstanKG996
LaosLA856
LatviaLV371
LebanonLB961
LesothoLS266
LiberiaLR231
LibyaLY218
LiechtensteinLI423
LithuaniaLT370
LuxembourgLU352
MacaoMO853
MacedoniaMK389
MadagascarMG261
MalawiMW265
MalaysiaMY60
MaldivesMV960
MaliML223
MaltaMT356
Marshall IslandsMH692
MartiniqueMQ596
MauritaniaMR222
MauritiusMU230
MexicoMX52
MicronesiaFM691
MoldovaMD373
MonacoMC377
MongoliaMN976
MontenegroME382
MontserratMS1
MoroccoMA212
MozambiqueMZ258
MyanmarMM95
NamibiaNA264
NauruNR674
NepalNP977
NetherlandsNL31
Netherlands Antilles*AN599
New CaledoniaNC687
New ZealandNZ64
NicaraguaNI505
NigerNE227
NigeriaNG234
NiueNU683
North KoreaKP850
Northern Mariana IslandsMP1
NorwayNO47
OmanOM968
PakistanPK92
PalauPW680
PalestinePS970
PanamaPA507
Papau New GuineaPG675
ParaguayPY595
PeruPE51
PhillippinesPH63
PolandPL48
PortugalPT351
Puerto RicoPR1
QatarQA974
ReunionRE262
RomaniaRO40
RussiaRU7
RwandaRW250
Saint HelenaSH290
Saint Kitts and NevisKN1
Saint LuciaLC1
Saint Pierre and MiquelonPM508
Saint Vincent and GrenadinesVC1
SamoaWS685
San MarinoSM378
Sao Tome and PrincipeST239
Saudi ArabiaSA966
SenegalSN221
SerbiaRS381
SeychellesSC248
Sierra LeoneSL232
SingaporeSG65
SlovakiaSK421
SloveniaSI386
Solomon IslandsSB677
SomaliaSO252
South AfricaZA27
South KoreaKR82
SpainES34
Sri LankaLK94
SudanSD249
SurinameSR597
SwazilandSZ268
SwedenSE46
SwitzerlandCH41
SyriaSY963
TaiwanTW886
TajikistanTJ992
TanzaniaTZ255
ThailandTH66
TogoTG228
TokelauTK690
TongaTO676
Trinidad and TobagoTT1
TunisiaTN216
TurkeyTR90
TurkmenistanTM993
Turks and Caicos IslandsTC1
TuvaluTV688
US Virgin IslandsVI1
UgandaUG256
UkraineUA380
United Arab EmiratesAE971
United KingdomGB44
United StatesUS1
UruguayUY598
UzbekistanUZ998
VanuatuVU678
Vatican CityVA379
VenezuelaVE58
VietnamVN84
Wallis and FutunaWF681
YemenYE967
ZambiaZM260
ZimbabweZW263

HTTP Codes Mapped to Error Codes

HTTP CodeError CodeAssociated Text StringProduct
40110002x-ts-nonce header value has been used recentlyAll
40110003x-ts-nonce header value is either too long or too shortAll
40110004Date or x-ts-date header is not within tolerable range
40110005Date or x-ts-date header is not RFC822 compliantAll
40110006Invalid x-ts-auth-method headerAll
40110007Missing required Date or x-ts-date header
40110008Invalid Signature.All
40110009Missing required Authorization headerAll
40110010CustomerID Account SuspendedAll
40110011This product is not enabled for this CustomerIDAll
40110012This feature is not enabled for this Customer IDAll
40110013Invalid Request. CustomerID Account Not FoundAll
40110014Invalid source IP addressAll
40110015Invalid customer IDAll
40410017CustomerID/ReferenceID not foundAll
42910019Rate Limit ExceededAll
42910020{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
40110021This product is not enabled for this countryAll
40110028Required Authorization header is not in the correct formatAll
40210030Insufficient funds in prepaid wallet.All
40110031Not Allowed HostAll
40010032Message blocked by TeleSignAll
40010033Unverified phone_number requested for trial account.All
40010034Call with declared type blocked in country requestedVoice
40110035The requested API host is not allowed for this customer_idAll
40410036reference_id expired.Messaging, Voice
40011000Invalid value for parameter phone_numberAll
40011001Invalid country code for parameter phone_numberAll
40011002Invalid value for parameter account_idScore
40011003Invalid value for parameter account_lifecycle_eventAll
40011004Invalid value for parameter callback_urlMessaging, Voice
40011005Invalid value for parameter customer_idAll
40011006Invalid value for parameter device_idScore
40011007Invalid value for email_addressScore
40011009Invalid value for parameter messageMessaging, Voice
40011011Invalid value for parameter reference_idAll
40011017Invalid value for parameter message_typeMessaging, Voice
40011018Invalid value for parameter voiceVoice
40012000Missing required parameter phone_numberAll
40012003Missing required parameter account_lifecycle_eventScore
40012009Missing required parameter messageMessaging, Voice
40012017Missing required parameter message_typeMessaging, Voice

Phone Number Cleansing Codes

CodeDescriptionDetail
100No Changes / ExactNo changes were made to the phone number. The phone number was formatted properly, and no cleansing was required.
101ChangedThe 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.
102Restricted NumberThe 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.
103No MatchThe phone number appears to be formatted correctly, but cannot be matched to any specific area.
104InvalidThe phone number is not correctly formatted.
105Partial MatchThe phone number length is too long or too short.

Phone Type Codes

CodeDescriptionRiskActionDetail
1FIXED_LINELowAllowFixed-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.
2MOBILEMedium-LowAllowMobile 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.
3PREPAID (for prepaid mobile)Medium-HighFlagThese 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.
4TOLL_FREEHighBlockToll-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.
5VOIP (non-fixed VOIP)HighBlockVoice 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.
6PAGERHighBlockThis 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.
7PAYPHONEHighBlockCalls to a payphone cannot be traced back to any one person; therefore, we recommend blocking verification calls to these numbers.
8INVALIDHighBlockThe telephone number entered is not a valid number.
9RESTRICTED_PREMIUM (Restricted Number)HighBlockThe 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
10PERSONALMedium-LowAllowA “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.
11VOICEMAILMedium-HighBlockVoicemail 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.
20OTHERMedium-HighBlockPhone 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.

AbbreviationNameUTC Offset
ACDTAustralian Central Daylight TimeUTC+10:30
ACSTAustralian Central Standard TimeUTC+09:30
ACTASEAN Common TimeUTC+08
ADTAtlantic Daylight TimeUTC-03
AEDTAustralian Eastern Daylight TimeUTC+11
AESTAustralian Eastern Standard TimeUTC+10
AFTAfghanistan TimeUT+04:30
AKDTAlaska Daylight TimeUTC-08
AKSTAlaska Standard TimeUTC-09
AMSTArmenia Summer TimeUTC+05
AMTArmenia TimeUTC+04
ARTArgentina TimeUTC-03
ASTArab Standard Time (Huwait, Riyadh)UTC+03
ASTArabian Standard Time (Abu Dhabi, Muscat)UTC+04
ASTArabic Standard Time (Baghdad)UTC+03
ASTAtlantic STandard TimeUTC+04
AWDTAustralian Western Daylight TimeUTC+09
AWSTAustralian Western Standard TimeUTC+08
AZOSTAzores Standard TimeUTC-01
AZTAzerbaijan TimeUTC+04
BDTBrunei TimeUTC+08
BIOTBritish Indian Ocean TimeUTC+06
BITBaker Island TimeUTC-12
BOTBolivia TimeUTC-04
BRTBrasilia TimeUTC-03
BSTBangladesh Standard TimeUTC+06
BSTBritish Summer Time (British Standard Time from Feb 1968 to Oct 1971)
BTTBhutan TimeUTC+06
CATCentral Africa TimeUTC+02
CCTCocos Islands TimeUTC+06:30
CDTCentral Daylight Time (North America)UTC-05
CEDTCentral European Daylight TimeUTC+02
CESTCentral European Summer Time (Cf. HAEC)UTC+02
CETCentral European TimeUTC+01
CHADTChatham Daylight TimeUTC+13:45
CHASTChatham STandard TimeUTC+12:45
CHOTChoibalsanUTC-08
CHSTChamorro Standard TimeUTC+10
CHUTChuuk TimeUTC+10
CISTClipperton Island Standard TimeUTC-08
CITCentral Indonesia TimeUTC+08
CKTCook Island TimeUTC-10
CLSTChile Summer TimeUTC-03
CLTChile Standard TimeUTC-04
COSTColombia Summer TimeUTC-04
COTColombia TimeUTC-05
CSTCentral Standard Time (North America)UTC-06
CSTChina Standard TimeUTC+08
CSTCentral Standard Time (Australia)UTC+09:30
CSTCentral Summer Time (Australia)UTC+10:30
CSTCuba Standard TimeUTC-05
CTChina TimeUTC+08
CVTCape Verde TimeUTC-01
CWSTCentral Western Standard Time (Australia)UTC+08:45
CXTChristmas Island TimeUTC+07
DAVTDavis TimeUTC+07
DDUTDumont d'Urville TimeUTC+07
DFTAIX specific equivalent of Central Eurpoean TimeUTC+01
EASSTEaster Island Standard Summer TimeUTC-05
EASTEaster Island Standard TimeUTC-06
EATEast Africa TimeUTC+03
ECTEastern Caribbean Time (does not recognize DST)UTC-04
ECTEcuador TimeUTC-05
EDTEastern Daylight Time (North America)UTC-04
EEDTEastern European Daylight TimeUTC+03
EESTEastern European Summer TimeUTC+03
EETEastern European TimeUTC+02
EGSTEastern Greenland Summer TimeUTC+00
EGTEastern Greenland TimeUTC-01
EITEastern Indonesian TimeUTC+09
ESTEastern Standard Time (North America)UTC-05
ESTEastern STandard Time (Australia)UTC+10
FETFurther-eastern_European_TimeUTC+03
FJTFiji TimeUTC+12
FKSTFalkland Islands Summer TimeUTC-03
FKTFalkland Islands TimeUTC-04
FNTFernando de Noronha TimeUTC-02
GALTGalapagos TimeUTC-06
GAMTGambier IslandsUTC-09
GETGeorgia Standard TimeUTC+04
GFTFrench Guiana TimeUTC-03
GILTGilbert Island TimeUTC+12
GITGambier Island TimeUTC-09
GMTGreenwich Mean TimeUTC
GSTGulf Standard TimeUTC+04
GYTGuyana TimeUTC-04
HADTHawaii-Aleutian Daylight TimeUTC-09
HAECHeure Avancée d’Europe Centrale francised name for CESTUTC+02
HASTHawaii-Aleutian Standard TimeUTC-10
HKTHong Kong TimeUTC+08
HMTHeard and McDonalds Islands TimeUTC+05
HOVTKhovd TimeUTC+07
HSTHawaii Standard TimeUTC-10
ICTIndochina TimeUTC+07
IDTIsrael Daylight TimeUTC+08
IOTIndian ocean TimeUTC+03
IRDTIran Daylight TimeUTC+08
IRKTIrkutsk TimeUTC+08
IRSTIran Standard TimeUTC+03:30
ISTIndian Standard TimeUTC+05:30
ISTIrish Summer TimeUTC+01
ISTIsrael Standard TimeUTC+02
JSTJapan Standard TimeUTC+09
KGTKyrgyzstan TimeUTC+07
KOSTKosrae TimeUTC+07
KRATKrasnoyarsk TimeUTC+07
KSTKorea Standard TimeUTC+09
LHSTLord Howe Standard TimeUTC+10:30
LHSTLord Howe Summer TimeUTC+11
LINTLine Islands TimeUTC+14
MAGTMagadan TimeUTC+12
MARTMarquesas Islands TimeUTC-09:30
MAWTMawson Station TimeUTC+05
MDTMountain Daylight Time (North America)UTC-06
METMiddle European Time Same zone as CETUTC+01
MESTMiddle European Saving Time Same zone as CESTUTC+02
MHTMarshall IslandsUTC+12
MISTMacquarie Island Station TimeUTC+11
MITMarquesas Islands TimeUTC-09:30
MMTMyanmar TimeUTC+06:30
MSKMoscow TimeUTC+04
MSTMalaysia Standard TimeUTC+08
MUTMauritius TimeUTC+04
MVTMaldives TimeUTC+05
MYTMalaysia TimeUTC+08
NCTNew Caledonia TimeUTC+11
NDTNewfoundland Daylight TimeUTC-02:30
NFTNorfolk Time[1]UTC+11:30
NPTNepal TimeUTC+05:45
NSTNewfoundland TimeUTC-03:30
NTNewfoundland TimeUTC-03:30
NUTNiue TimeUTC-11:30
NZDTNew Zealand Daylight TimeUTC+13
NZSTNew Zealand Standard TimeUTC+12
OMSTOmsk TimeUTC+06
ORATOral TimeUTC-05
PDTPacific Daylight Time (North America)UTC-07
PETPeru TimeUTC-05
PETTKamchatka TimeUTC+12
PGTPapua New Guinea TimeUTC+10
PHOTPhoenix Island TimeUTC+13
PHTPhilippine TimeUTC+08
PKTPakistan Standard TimeUTC+05
PMDTSaint Pierre and Miquelon Daylight TimeUTC+08
PMSTSaint Pierre and Miquelon Standard TimeUTC+08
PONTPohnpei Standard TimeUTC+11
PSTPacific Standard Time (North America)UTC-08
PSTPhilippine Standard TimeUTC+08
RETReunion TimeUTC+04
ROTTRothera Research Station TimeUTC-03
SAKTSakhalin Island TImeUTC+11
SAMTSamara TimeUTC+04
SASTSouth African Standard TimeUTC+02
SBTSolomon Islands TimeUTC+11
SCTSeychelles TimeUTC+04
SGTSingapore TimeUTC+08
SLTSri Lanka TimeUTC+05:30
SRTSuriname TimeUTC-03
SSTSamoa Standard TimeUTC-11
SYOTShowa Station TimeUTC+03
TAHTTahiti TimeUTC-10
THAThailand Standard TimeUTC+07
TFTIndian/KerguelenUTC+05
TJTTajikistan TimeUTC+05
TKTTokelau TimeUTC+14
TLTTimor Leste TimeUTC+09
TMTTurkmenistan TimeUTC+05
TOTTonga TimeUTC+13
TVTTuvalu TimeUTC+12
UCTCoordinated Universal TimeUTC
ULATUlaanbaatar TimeUTC+08
UTCCoordinated Universal TimeUTC
UYSTUruguay Summer TimeUTC-02
UYT Uruguay Standard TimeUTC-03
UZTUzbekistan TimeUTC+05
VETVenezuelan Standard TimeUTC-04:30
VLATVladivostok TimeUTC+10
VOLTVolgograd TimeUTC+04
VOSTVostok Station TimeUTC+06
VUTVanuatu TimeUTC+11
WAKTWake Island TimeUTC+12
WASTWest Africa Summer TimeUTC+02
WATWest Africa TimeUTC+01
WEDTWestern European Daylight TimeUTC+01
WESTWestern European Summer TimeUTC+01
WETWestern European TimeUTC
WSTWestern Standard TimeUTC+08
YAKTYakutsk TimeUTC+09
YEKTYekaterinburg TimeUTC+05

Did this page help you?