Data Format Policies

Phone Numbers

Number Formats

Phone numbers must be include the following:

1. Country code: Usually 1-3 digits. For a full list of country code, see here. This stored in the countryCode property within the Phone node.
2. Area code: As per the country's guidelines
3. Local phone number: 8-15 digits

Phone numbers within Auth Data are stored in separate country code and area code + number sections, without additional characters such as spaces, dashes, or parenthesis within the number. Examples:

• United States phone number "(310) 555-9876" would be entered as 1 in the countryCode property and 3109948954 in number property.
• United Kingdom phone number "(0)20 3476 1234", which uses a leading zero in an area code, would be entered as 44 in the countryCode and 2034761234 in the number propperty.

Extensions

A phone extension is a short number that is added to a business phone line to direct calls to a specific person or department. Within Auth Data, extensions must be numerical values only. For example, "x1234" or "ext. 1234" are entered simply as 1234.

Addresses

Locality

The locality, usually the city, in which the street address is, and which is in the region. For example, "Los Angeles". Localities specified in an address must adhere to the following:

1. Appropriate capitalization (e.g., "los angeles" is incorrect)
2. No abbreviations (e.g. "LA" as an abbreviation for "Los Angeles" is incorrect)
3. Localities must not include additional information (e.g, "Los Angeles CA" is incorrect)
4. Localities must not include superfluous punctuation (e.g., "Los Angeles," in incorrect)

Additional concerns:

• In large metropolitan areas, boroughs can be used as a locality. For example: the London borrough of "Camden Town" can be used in place of "London".
• Some cities such as Prague require an additional city district such as "Praha 1".
• Military addresses within the United States must designate APO, FPO or DPO as the locality
• Mexico: The abbreviation "CDMX" is a valid locality in place of "Mexico City" or "Ciudad De Mexico"

Locality Names

A normalized, geocoded address returned by an API may return a "localized" name, for example, returning the city name "München" versus "Munich," a name which English-speaking users would more readily recognize. While the localized name is of course correct, in some cases may be desirable: UTA agents and buyers booking a touring engagement in Munich for a US-based artist will likely prefer that the tour routings and deal documents say "Munich."

The solution for this may be to provide a manually-maintained mapping table from the localized to the name for the purpose of API responses.

Region

The region in which the locality is, and which is in the country. For example, California or Ontario or another appropriate first-level Administrative division. Regions specified in an address must adhere to the following:

1. Appropriate capitalization (e.g., "California" is correct; "CALIFORNIA" is not)
2. No abbreviations. For regions with common abbreviations, the regionAbbreviation property is used.
3. Regions must not include additional information (e.g, for the region "Hawaii", "Hawaii, US" is incorrect)
4. Regions must not include superfluous punctuation (e.g. "Tennessee," is incorrect)
5. Regions are not countries. Countries should be designated using the country property.

Additional formatting rules:

• United Kingdom: Countries within the UK, such as "England", are not valid region names
• United Kingdom and Ireland: County names are optional and valid region names
• When no region exists, values must be kept as null values instead of using filler values such as spaces, dashes, "N/A", "None" or other similar values.
• United States: Military addresses must designated AA (Americas), AE (Europe) or AP (Pacific) as the Region. See Military Mail for more information.

Postal Codes

Postal codes are vital for efficient mail delivery and logistics. However, their formats vary significantly across countries, making consistent data management essential. Each country has a unique postal code system, often combining letters and numbers in specific sequences. The table below outlines postal code formats for the most common countries in UTA parties are located:

Country	Format	Formating Concerns
United States Mexico Puerto Rico (US) Vigin Islands (US)	5 digit codes (e.g., 12345), optionally extended with 4 more digits (ZIP+4: 12345-6789)	- No spaces are used between the ZIP and +4 segments
United Kingdom	Alphanumeric, with a space separating two segments and the last segment containing three characters (e.g., SW1A 1AA)
Canada	Alternating letters and numbers with a space in the middle (e.g., K1A 0B1)
Ireland	7 alphanumeric digits, with a space separating two segments and the last segment containing four characters (e.g. D02 X285)	Legacy 1 and 2 numeric digit postal codes for Dublin are not acceptable as those are now incorportated into the new format ("Dublin 02" has become the prefix D02)
Iceland	3 numeric digits (e.g., 101)
Australia Austria Belgium Bulgaria Cyprus Denmark Georgia Hungary Venezuela Lebanon Norway Philippines Slovenia South Africa Switzerland	4 numeric digits (e.g., 2000)
Netherlands	4 digits followed by two letters, separated by a space (e.g., 1234 AB)
Bermuda	2 letters followed by 2 numeric digits with a space in the middle	For PO Boxes, postal codes are four letters separated by a space between the second and third letters
Finland Germany Croatia Costa Rica Dominican Republic Egypt France Indonesia Iraq Italy Kuwait Malasia New Zealand Peru Spain Thailand Ukraine	5 numeric digits (e.g., 00100)
Brazil	5 numeric digits, followed by a dash, followed by 3 numeric digits	When no trailing 3 digits are available, use 000 as the trailing digits (e.g., 88200-000)
Saudi Arabia	5 numeric digits with an optional four additional numbers. separated by a hyphen (e.g., 01234-0123)
Czechia Sweden Slovakia	5 numeric digits with a space between the 3rd and 4th digit. (e.g., 100 73 )
Poland	5 numeric digits with a hyphen between the 2nd and 3rd digit. (e.g., 02-550 )
Belarus China Columbia India Nigeria Romania Russia Singapore Trinidad and Tobago	6 numeric digits (e.g., 220049)
Chile Israel	7 numeric digits (e.g., 7501068)
Portugal	7 numeric digits with a hyphen after the first four dgits (e.g., 1200-769
Japan	7 numeric digits with a hyphen after the first three dgits (e.g., 170-3293
Argentina	Single letter, followed by 4 numeric digits, followed by three letters (e.g., A9999AAA)
Andorra	"AD" followed by three numeric digits (e.g., AD100)
Cayman Islands	"KY", followed by number from 1-3, followed by a hyphen, followed by a 4 digit number (e.g., KY1-1100)
Faroe Islands	"FO" followed bt 3 digits separated by a dash (e.g., FO-100)
Virgin Islands (British)	Country code "VG" followed by 4 digits (e.g., VG1110)
Latvia	"LV", followed by a hyphen, followed by a 4 digit number (e.g., LV-1007)
Lithuania	5 numberic digits that can optionally be preceeded by "LT-" (e.g., LT-01234 or 01234)
Luxembourg	"L-" followed by a 4 digit number (e.g., L-1007)
Malta	3 letters followed by a 4 digit number, separated by a space (e.g., MTP 1001)
UAE	No formal postal codes exist, but post codes field can be used to for Onwani (QR code) or Makani (unique 10-digit building number) location systems
Bahamas Belize Hong Kong (China) Curaçao Jamaica Qatar	No postal codes exist. Value should be left as null

Additional formatting rules:

• When no postal codes exist, values must be kept as null values instead of using filler values such as spaces, dashes, "N/A", "None" or other similar values.
• Correctly formatted postal codes do not have additional spaces or other hidden characters before or after the postal code. For example, "90068" is a correct postal code value but " 90068 " is not.
• Letters used in postal codes are always capitalized
• US addresses in overseas military bases use US Zip Code format above but with an additional prefix designating either military, fleet or diplomatic post offices. See Military Mail for more information.

Country

The two-letter ISO 3166-1 alpha-2 country code

Additional formatting rules:

1. United Kingdom: The country code "UK" is used for the United Kingdom all states within it (e.g., England, Scotland, Wales, Northern Ireland)
2. United States: Addresses using military mail must have "US" as its country, not the country where the military base is located