Phone numbers and country codes

Accepted phone formats, country and calling codes, country-specific lengths, and examples.

Use a complete international phone number whenever possible, such as +12025550142. Tringify stores accepted numbers in E.164 format: a plus sign, calling code, and number, with no spaces or punctuation. Successful validation checks the number’s format and numbering range; it does not prove ownership, that the number is assigned, or that it can receive SMS. Verification is a separate step.

Country codes and calling codes#

Value	Meaning	Example
phone_country_code / country_code	Two-letter country or region identifier. Use a code returned by the phone reference endpoint.	IN, US, GB
dial_code	International calling prefix. Several regions can share one prefix.	+91 for India; +1 for both the US and Canada
national_prefix	Prefix used when dialing a national number. Do not count it as part of the significant number or remove all leading zeroes yourself.	0 in the UK; Italy’s significant leading zero is retained

For customer creation, phone_country_code supplies the country for a number written in national format. Use IN, not India, 91, or +91. The hint is trimmed and case-insensitive. When a number starts with an international calling code, the number determines its region: +91 98765 43210 is Indian even with a US hint. The saved phone_country_code reflects the detected region. A valid global number such as +80012345678 has no two-letter country and is saved without a country code.

What a valid number requires#

A customer contact number must be a valid complete number and have one of the significant-digit lengths listed for its region below. Those lengths are based on the region’s fixed-line and mobile lengths. The exact allowed lengths matter: a minimum of 7 and maximum of 10 does not mean 8 and 9 are accepted unless they are listed. Having the right number of digits is not enough; the area code and remaining digits must also form a recognized numbering range.

Spaces, parentheses, and hyphens are accepted when the number can be parsed. National dialing prefixes are interpreted for the selected country. Do not strip leading zeroes indiscriminately: some countries, including Italy, keep a zero in the international number. Extensions are not stored: +1 2025550142 ext 123 becomes +12025550142. Store extension information separately if you need it.

These rules are not a blanket ban on toll-free or other number types. For example, +18005551234 is accepted; India’s 18601234567 is rejected because its 11 significant digits exceed India’s 10-digit contact length. Valid non-geographic international numbers can be accepted without a country-specific length restriction. Use the validation result rather than assuming all numbers of a particular type are accepted or rejected.

Which field you are filling#

Field or workflow	Rule
Create customer: phone and phone_country_code	Phone is optional. Supply an international number or a national number with a two-letter region hint. The contact length rules below apply. A normalized phone cannot belong to two customers in the same store.
Customer Import CSV: Phone	Optional. Use +calling-code international format: the CSV has no separate phone-country hint. Bare national numbers are rejected. A successful import stores the normalized number and detected region.
Customer Update CSV	Phone is a reference column; it does not update the customer’s number.
Customer address: phone; CSV Address Phone	Optional and separate from the customer’s profile number. A national number uses the address country as a hint; an international prefix determines its own region. Address phones must be valid complete numbers, but do not use the profile’s additional contact-length restriction.
Update customer API	Phone and phone_country_code are not editable through the profile update endpoint. Do not submit them as update fields.
Blank optional phone	Leave it out or leave the optional field blank. A country choice alone is not a phone number. Requiredness can differ for other resources; check the relevant endpoint.

Accepted and rejected examples#

Input	Region hint	Customer contact result	Saved number
9876543210	IN	Accepted	+919876543210
09876543210	IN	Accepted	+919876543210
+91 98765 43210	US	Accepted	+919876543210
1111111111	IN	Rejected	—
18601234567	IN	Rejected	—
020 7946 0018	GB	Accepted	+442079460018
+1 (202) 555-0142	None	Accepted	+12025550142
2025550142	None	Rejected	—
+80012345678	IN	Accepted	+80012345678
+1 2025550142 ext 123	US	Accepted	+12025550142
+390212345678	IT	Accepted	+390212345678

Examples demonstrate formatting and validation only. They are not contacts to call or message. A rejected create returns CUSTOMER_PHONE_INVALID; a duplicate normalized customer phone returns CUSTOMER_PHONE_DUPLICATE. Address validation errors use the address endpoint’s error contract. Read the error response and allow the user to correct the number and country.

Build a country selector#

GET /api/2025-01/reference/phone-codes returns all calling regions in one response. Use country_code as the identifier, country_name as the label, and dial_code for display. possible_lengths lists accepted significant-digit lengths; min_national_digits and max_national_digits are convenient bounds, not substitutes for the list. national_prefix and example_number help explain national formatting. The endpoint requires a valid Store API token and follows the reference-data cache policy. Do not permanently hard-code country lengths; numbering plans can change.

json

{
  "data": {
    "phone_codes": [
      {
        "possible_lengths": [
          10
        ],
        "min_national_digits": 10,
        "max_national_digits": 10,
        "national_prefix": "0",
        "country_code": "IN",
        "country_name": "India",
        "dial_code": "+91",
        "dial_code_numeric": 91,
        "example_number": "074104 10123",
        "flag": "🇮🇳"
      },
      {
        "possible_lengths": [
          10
        ],
        "min_national_digits": 10,
        "max_national_digits": 10,
        "national_prefix": "1",
        "country_code": "US",
        "country_name": "United States",
        "dial_code": "+1",
        "dial_code_numeric": 1,
        "example_number": "(201) 555-0123",
        "flag": "🇺🇸"
      }
    ]
  },
  "success": true
}

Country-by-country contact lengths#

Significant digits exclude the international calling code and any removable national dialing prefix. The table lists every supported calling region. Local examples may include a dialing prefix or formatting characters, so their visible character count can be longer than the significant-digit length. Check complete number validity as well as length.

Country or region	Code	Calling code	Allowed significant digits	National prefix	National-format example
Afghanistan	AF	+93	9	0	023 456 7890
Albania	AL	+355	8, 9	0	022 345 678
Algeria	DZ	+213	8, 9	0	012 34 56 78
American Samoa	AS	+1	10	1	(684) 622-1234
Andorra	AD	+376	6, 9	—	712 345
Angola	AO	+244	9	—	222 123 456
Anguilla	AI	+1	10	1	(264) 461-2345
Antigua & Barbuda	AG	+1	10	1	(268) 460-1234
Argentina	AR	+54	10, 11	0	011 2345-6789
Armenia	AM	+374	8	0	(010) 123456
Aruba	AW	+297	7	—	521 2345
Ascension Island	AC	+247	5	—	62889
Australia	AU	+61	9	0	(02) 1234 5678
Austria	AT	+43	4, 5, 6, 7, 8, 9, 10, 11, 12, 13	0	01 234567890
Azerbaijan	AZ	+994	9	0	(012) 312 34 56
Bahamas	BS	+1	10	1	(242) 345-6789
Bahrain	BH	+973	8	—	1700 1234
Bangladesh	BD	+880	6, 7, 8, 9, 10	0	02-7111234
Barbados	BB	+1	10	1	(246) 412-3456
Belarus	BY	+375	9	8	8 0152 45-09-11
Belgium	BE	+32	8, 9	0	012 34 56 78
Belize	BZ	+501	7	—	222-1234
Benin	BJ	+229	10	—	01 20 21 12 34
Bermuda	BM	+1	10	1	(441) 412-3456
Bhutan	BT	+975	7, 8	—	2 345 678
Bolivia	BO	+591	8	0	2 2123456
Bosnia & Herzegovina	BA	+387	8, 9	0	030 212-345
Botswana	BW	+267	7, 8	—	240 1234
Brazil	BR	+55	10, 11	0	(11) 2345-6789
British Indian Ocean Territory	IO	+246	7	—	370 9100
British Virgin Islands	VG	+1	10	1	(284) 229-1234
Brunei	BN	+673	7	—	234 5678
Bulgaria	BG	+359	6, 7, 8, 9	0	02 123 456
Burkina Faso	BF	+226	8	—	20 49 12 34
Burundi	BI	+257	8	—	22 20 12 34
Cambodia	KH	+855	8, 9	0	023 756 789
Cameroon	CM	+237	9	—	2 22 12 34 56
Canada	CA	+1	10	1	(506) 234-5678
Cape Verde	CV	+238	7	—	221 12 34
Caribbean Netherlands	BQ	+599	7	—	715 1234
Cayman Islands	KY	+1	10	1	(345) 222-1234
Central African Republic	CF	+236	8	—	21 61 23 45
Chad	TD	+235	8	—	22 50 12 34
Chile	CL	+56	9	—	600 123 456
China	CN	+86	7, 8, 9, 10, 11	0	010 1234 5678
Christmas Island	CX	+61	9	0	(08) 9164 1234
Cocos (Keeling) Islands	CC	+61	9	0	(08) 9162 1234
Colombia	CO	+57	8, 10	0	(601) 2345678
Comoros	KM	+269	7	—	771 23 45
Congo - Brazzaville	CG	+242	9	—	22 212 3456
Congo - Kinshasa	CD	+243	7, 8, 9, 10	0	012 34567
Cook Islands	CK	+682	5	—	21 234
Costa Rica	CR	+506	8	—	2212 3456
Croatia	HR	+385	8, 9	0	01 2345 678
Cuba	CU	+53	6, 7, 8, 10	0	(07) 1234567
Curaçao	CW	+599	7, 8	—	9 435 1234
Cyprus	CY	+357	8	—	22 345678
Czechia	CZ	+420	9	—	212 345 678
Côte d’Ivoire	CI	+225	10	—	21 23 4 56789
Denmark	DK	+45	8	—	32 12 34 56
Djibouti	DJ	+253	8	—	21 36 00 03
Dominica	DM	+1	10	1	(767) 420-1234
Dominican Republic	DO	+1	10	1	(809) 234-5678
Ecuador	EC	+593	8, 9	0	(02) 212-3456
Egypt	EG	+20	8, 9, 10	0	02 34567890
El Salvador	SV	+503	8	—	2123 4567
Equatorial Guinea	GQ	+240	9	—	333 091 234
Eritrea	ER	+291	7	0	08 370 362
Estonia	EE	+372	7, 8	—	321 2345
Ethiopia	ET	+251	9	0	011 111 2345
Falkland Islands	FK	+500	5	—	31234
Faroe Islands	FO	+298	6	—	201234
Fiji	FJ	+679	7	—	321 2345
Finland	FI	+358	5, 6, 7, 8, 9, 10	0	013 1234567
France	FR	+33	9	0	01 23 45 67 89
French Guiana	GF	+594	9	0	0594 10 12 34
French Polynesia	PF	+689	8	—	40 41 23 45
Gabon	GA	+241	7, 8	—	01 44 12 34
Gambia	GM	+220	7	—	566 1234
Georgia	GE	+995	9	0	032 212 34 56
Germany	DE	+49	5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15	0	030 123456
Ghana	GH	+233	9	0	030 234 5678
Gibraltar	GI	+350	8	—	200 12345
Greece	GR	+30	10	—	21 2345 6789
Greenland	GL	+299	6	—	32 10 00
Grenada	GD	+1	10	1	(473) 269-1234
Guadeloupe	GP	+590	9	0	0590 20 12 34
Guam	GU	+1	10	1	(671) 300-1234
Guatemala	GT	+502	8	—	2245 6789
Guernsey	GG	+44	10	0	01481 256789
Guinea	GN	+224	8, 9	—	30 24 12 34
Guinea-Bissau	GW	+245	9	—	443 201 234
Guyana	GY	+592	7	—	220 1234
Haiti	HT	+509	8	—	22 45 3300
Honduras	HN	+504	8	—	2212-3456
Hong Kong SAR China	HK	+852	8	—	2123 4567
Hungary	HU	+36	8, 9	06	(06 1) 234 5678
Iceland	IS	+354	7, 9	—	410 1234
India	IN	+91	10	0	074104 10123
Indonesia	ID	+62	7, 8, 9, 10, 11, 12	0	(021) 8350123
Iran	IR	+98	6, 7, 10	0	021 2345 6789
Iraq	IQ	+964	8, 9, 10	0	01 234 5678
Ireland	IE	+353	7, 8, 9, 10	0	(022) 12345
Isle of Man	IM	+44	10	0	01624 756789
Israel	IL	+972	8, 9, 11, 12	0	02-123-4567
Italy	IT	+39	6, 7, 8, 9, 10, 11, 12	—	02 1234 5678
Jamaica	JM	+1	10	1	(876) 523-0123
Japan	JP	+81	9, 10	0	03-1234-5678
Jersey	JE	+44	10	0	01534 456789
Jordan	JO	+962	8, 9	0	(06) 200 1234
Kazakhstan	KZ	+7	10	8	8 (71234) 5 67 89
Kenya	KE	+254	7, 8, 9	0	020 2012345
Kiribati	KI	+686	5, 8	0	31234
Kosovo	XK	+383	8, 9, 10, 11, 12	0	028 012 345
Kuwait	KW	+965	8	—	2234 5678
Kyrgyzstan	KG	+996	9	0	0312 123 456
Laos	LA	+856	8, 9, 10	0	021 212 862
Latvia	LV	+371	8	—	63 123 456
Lebanon	LB	+961	7, 8	0	01 123 456
Lesotho	LS	+266	8	—	2212 3456
Liberia	LR	+231	7, 8, 9	0	021 234 567
Libya	LY	+218	9	0	021-2345678
Liechtenstein	LI	+423	7, 9	0	234 56 78
Lithuania	LT	+370	8	0	(0-312) 34567
Luxembourg	LU	+352	4, 5, 6, 7, 8, 9, 10, 11	—	27 12 34 56
Macau SAR China	MO	+853	8	—	2821 2345
Macedonia	MK	+389	8	0	02 201 2345
Madagascar	MG	+261	9	0	020 21 234 56
Malawi	MW	+265	7, 9	0	01 234 567
Malaysia	MY	+60	8, 9, 10	0	03-2385 6789
Maldives	MV	+960	7	—	670-1234
Mali	ML	+223	8	—	20 21 23 45
Malta	MT	+356	8	—	2100 1234
Marshall Islands	MH	+692	7	1	247-1234
Martinique	MQ	+596	9	0	0596 30 12 34
Mauritania	MR	+222	8	—	35 12 34 56
Mauritius	MU	+230	7, 8	—	5448 0123
Mayotte	YT	+262	9	0	0269 60 12 34
Mexico	MX	+52	10	—	200 123 4567
Micronesia	FM	+691	7	—	320 1234
Moldova	MD	+373	8	0	022 212 345
Monaco	MC	+377	8, 9	0	99 12 34 56
Mongolia	MN	+976	8, 9, 10	0	5312 3456
Montenegro	ME	+382	8	0	030 234 567
Montserrat	MS	+1	10	1	(664) 491-2345
Morocco	MA	+212	9	0	05 20 12 34 56
Mozambique	MZ	+258	8, 9	—	21 123 456
Myanmar (Burma)	MM	+95	6, 7, 8, 9, 10	0	01 234 567
Namibia	NA	+264	8, 9	0	061 221 234
Nauru	NR	+674	7	—	444 1234
Nepal	NP	+977	8, 10	0	01-4567890
Netherlands	NL	+31	9, 11	0	010 123 4567
New Caledonia	NC	+687	6	—	20.12.34
New Zealand	NZ	+64	8, 9, 10	0	03 234 5678
Nicaragua	NI	+505	8	—	2123 4567
Niger	NE	+227	8	—	20 20 12 34
Nigeria	NG	+234	10	0	02033 12 3456
Niue	NU	+683	4, 7	—	7012
Norfolk Island	NF	+672	6	—	10 6609
North Korea	KP	+850	8, 10	0	02 123 4567
Northern Mariana Islands	MP	+1	10	1	(670) 234-5678
Norway	NO	+47	8	—	21 23 45 67
Oman	OM	+968	8	—	23 123456
Pakistan	PK	+92	9, 10	0	(021) 23456789
Palau	PW	+680	7	—	277 1234
Palestinian Territories	PS	+970	8, 9	0	02 223 4567
Panama	PA	+507	7, 8	—	200-1234
Papua New Guinea	PG	+675	7, 8	—	312 3456
Paraguay	PY	+595	7, 8, 9	0	(021) 234 5678
Peru	PE	+51	8, 9	0	(01) 1234567
Philippines	PH	+63	6, 8, 9, 10	0	(02) 3234 5678
Poland	PL	+48	7, 9	—	12 345 67 89
Portugal	PT	+351	9	—	21 234 5678
Puerto Rico	PR	+1	10	1	(787) 234-5678
Qatar	QA	+974	8	—	4412 3456
Romania	RO	+40	6, 9	0	021 123 4567
Russia	RU	+7	10	8	8 (301) 123-45-67
Rwanda	RW	+250	8, 9	0	250 123 456
Réunion	RE	+262	9	0	0262 16 12 34
Samoa	WS	+685	5, 6, 7, 10	—	22123
San Marino	SM	+378	8, 10	—	0549 886377
Saudi Arabia	SA	+966	9	0	011 234 5678
Senegal	SN	+221	9	—	30 101 23 45
Serbia	RS	+381	7, 8, 9, 10, 11, 12	0	010 234567
Seychelles	SC	+248	7	—	4 217 123
Sierra Leone	SL	+232	8	0	(022) 221234
Singapore	SG	+65	8	—	6123 4567
Sint Maarten	SX	+1	10	1	(721) 542-5678
Slovakia	SK	+421	6, 7, 9	0	02 212 345 67
Slovenia	SI	+386	8	0	(01) 234 56 78
Solomon Islands	SB	+677	5, 7	—	40123
Somalia	SO	+252	6, 7, 8, 9	0	4 012345
South Africa	ZA	+27	5, 6, 7, 8, 9	0	010 123 4567
South Korea	KR	+82	5, 6, 8, 9, 10	0	02-212-3456
South Sudan	SS	+211	9	0	0181 234 567
Spain	ES	+34	9	—	810 12 34 56
Sri Lanka	LK	+94	9	0	0112 345 678
St. Barthélemy	BL	+590	9	0	0590 27 12 34
St. Helena	SH	+290	4, 5	—	22158
St. Kitts & Nevis	KN	+1	10	1	(869) 236-1234
St. Lucia	LC	+1	10	1	(758) 430-5678
St. Martin	MF	+590	9	0	0590 27 12 34
St. Pierre & Miquelon	PM	+508	6, 9	0	043 01 23
St. Vincent & Grenadines	VC	+1	10	1	(784) 266-1234
Sudan	SD	+249	9	0	015 312 3456
Suriname	SR	+597	6, 7	—	211-234
Svalbard & Jan Mayen	SJ	+47	8	—	79 12 34 56
Swaziland	SZ	+268	8	—	2217 1234
Sweden	SE	+46	7, 8, 9	0	08-12 34 56
Switzerland	CH	+41	9	0	021 234 56 78
Syria	SY	+963	8, 9	0	011 234 5678
São Tomé & Príncipe	ST	+239	7	—	222 1234
Taiwan	TW	+886	8, 9	0	02 2123 4567
Tajikistan	TJ	+992	9	—	372 12 3456
Tanzania	TZ	+255	9	0	022 234 5678
Thailand	TH	+66	8, 9	0	02 123 4567
Timor-Leste	TL	+670	7, 8	—	211 2345
Togo	TG	+228	8	—	22 21 23 45
Tokelau	TK	+690	4, 5, 6, 7	—	3101
Tonga	TO	+676	5, 7	—	20-123
Trinidad & Tobago	TT	+1	10	1	(868) 221-1234
Tristan da Cunha	TA	+290	4	—	8999
Tunisia	TN	+216	8	—	30 010 123
Turkey	TR	+90	10	0	(0212) 345 67 89
Turkmenistan	TM	+993	8	8	(8 12) 34-56-78
Turks & Caicos Islands	TC	+1	10	1	(649) 712-1234
Tuvalu	TV	+688	5, 6, 7	—	20 123
U.S. Virgin Islands	VI	+1	10	1	(340) 642-1234
Uganda	UG	+256	9	0	031 2345678
Ukraine	UA	+380	9	0	03112 34567
United Arab Emirates	AE	+971	8, 9	0	02 234 5678
United Kingdom	GB	+44	9, 10	0	0121 234 5678
United States	US	+1	10	1	(201) 555-0123
Uruguay	UY	+598	8	0	2123 1234
Uzbekistan	UZ	+998	9	—	66 905 01 23
Vanuatu	VU	+678	5, 7	—	22123
Vatican City	VA	+39	6, 7, 8, 9, 10, 11	—	06 6981 2345
Venezuela	VE	+58	10	0	0212-1234567
Vietnam	VN	+84	9, 10	0	0210 1234 567
Wallis & Futuna	WF	+681	6	—	72 12 34
Western Sahara	EH	+212	9	0	05 28 81 23 45
Yemen	YE	+967	7, 8, 9	0	01 234 567
Zambia	ZM	+260	9	0	0211 234 567
Zimbabwe	ZW	+263	5, 6, 7, 8, 9, 10	0	013 12345
Åland Islands	AX	+358	6, 7, 8, 9, 10	0	018 1234567