# About non-U.S. addresses

Certain countries require a level of detail beyond the U.S. and Canadian `street1` / `street2` pair for specifying addresses. In supporting these countries' requirements, there are additional fields that need to be passed in carrier selection calls in order to guarantee that Shipium gets your packages to your customer correctly, regardless of which carrier you use.

# Per-country details

The acceptable 2-character [ISO-3166 country codes](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes#Current_ISO_3166_country_codes) are listed in the following table. These values are for the `countryCode` field.

|  |  |  |
| --- | --- | --- |
| 1 | Country Name | ISO 3166-1 Alpha-2 Code |
| 2 | Afghanistan | AF |
| 3 | Åland Islands | AX |
| 4 | Albania | AL |
| 5 | Algeria | DZ |
| 6 | American Samoa | AS |
| 7 | Andorra | AD |
| 8 | Angola | AO |
| 9 | Anguilla | AI |
| 10 | Antarctica | AQ |
| 11 | Antigua and Barbuda | AG |
| 12 | Argentina | AR |
| 13 | Armenia | AM |
| 14 | Aruba | AW |
| 15 | Australia | AU |
| 16 | Austria | AT |
| 17 | Azerbaijan | AZ |
| 18 | Bahamas (the) | BS |
| 19 | Bahrain | BH |
| 20 | Bangladesh | BD |
| 21 | Barbados | BB |
| 22 | Belarus | BY |
| 23 | Belgium | BE |
| 24 | Belize | BZ |
| 25 | Benin | BJ |
| 26 | Bermuda | BM |
| 27 | Bhutan | BT |
| 28 | Bolivia (Plurinational State of) | BO |
| 29 | Bonaire, Sint Eustatius and Saba | BQ |
| 30 | Bosnia and Herzegovina | BA |
| 31 | Botswana | BW |
| 32 | Bouvet Island | BV |
| 33 | Brazil | BR |
| 34 | British Indian Ocean Territory (the) | IO |
| 35 | Brunei Darussalam | BN |
| 36 | Bulgaria | BG |
| 37 | Burkina Faso | BF |
| 38 | Burundi | BI |
| 39 | Cabo Verde | CV |
| 40 | Cambodia | KH |
| 41 | Cameroon | CM |
| 42 | Canada | CA |
| 43 | Cayman Islands (the) | KY |
| 44 | Central African Republic (the) | CF |
| 45 | Chad | TD |
| 46 | Chile | CL |
| 47 | China | CN |
| 48 | Christmas Island | CX |
| 49 | Cocos (Keeling) Islands (the) | CC |
| 50 | Colombia | CO |
| 51 | Comoros (the) | KM |
| 52 | Congo (the Democratic Republic of the) | CD |
| 53 | Congo (the) | CG |
| 54 | Cook Islands (the) | CK |
| 55 | Costa Rica | CR |
| 56 | Côte d'Ivoire | CI |
| 57 | Croatia | HR |
| 58 | Cuba | CU |
| 59 | Curaçao | CW |
| 60 | Cyprus | CY |
| 61 | Czechia | CZ |
| 62 | Denmark | DK |
| 63 | Djibouti | DJ |
| 64 | Dominica | DM |
| 65 | Dominican Republic (the) | DO |
| 66 | Ecuador | EC |
| 67 | Egypt | EG |
| 68 | El Salvador | SV |
| 69 | Equatorial Guinea | GQ |
| 70 | Eritrea | ER |
| 71 | Estonia | EE |
| 72 | Eswatini | SZ |
| 73 | Ethiopia | ET |
| 74 | Falkland Islands (Malvinas) | FK |
| 75 | Faroe Islands (the) | FO |
| 76 | Fiji | FJ |
| 77 | Finland | FI |
| 78 | France | FR |
| 79 | French Guiana | GF |
| 80 | French Polynesia | PF |
| 81 | French Southern Territories (the) | TF |
| 82 | Gabon | GA |
| 83 | Gambia (the) | GM |
| 84 | Georgia | GE |
| 85 | Germany | DE |
| 86 | Ghana | GH |
| 87 | Gibraltar | GI |
| 88 | Greece | GR |
| 89 | Greenland | GL |
| 90 | Grenada | GD |
| 91 | Guadeloupe | GP |
| 92 | Guam | GU |
| 93 | Guatemala | GT |
| 94 | Guernsey | GG |
| 95 | Guinea | GN |
| 96 | Guinea-Bissau | GW |
| 97 | Guyana | GY |
| 98 | Haiti | HT |
| 99 | Heard Island and McDonald Islands | HM |
| 100 | Holy See (the) | VA |
| 101 | Honduras | HN |
| 102 | Hong Kong | HK |
| 103 | Hungary | HU |
| 104 | Iceland | IS |
| 105 | India | IN |
| 106 | Indonesia | ID |
| 107 | Iran (Islamic Republic of) | IR |
| 108 | Iraq | IQ |
| 109 | Ireland | IE |
| 110 | Isle of Man | IM |
| 111 | Israel | IL |
| 112 | Italy | IT |
| 113 | Jamaica | JM |
| 114 | Japan | JP |
| 115 | Jersey | JE |
| 116 | Jordan | JO |
| 117 | Kazakhstan | KZ |
| 118 | Kenya | KE |
| 119 | Kiribati | KI |
| 120 | Korea (the Democratic People's Republic of) | KP |
| 121 | Korea (the Republic of) | KR |
| 122 | Kuwait | KW |
| 123 | Kyrgyzstan | KG |
| 124 | Lao People's Democratic Republic (the) | LA |
| 125 | Latvia | LV |
| 126 | Lebanon | LB |
| 127 | Lesotho | LS |
| 128 | Liberia | LR |
| 129 | Libya | LY |
| 130 | Liechtenstein | LI |
| 131 | Lithuania | LT |
| 132 | Luxembourg | LU |
| 133 | Macao | MO |
| 134 | Madagascar | MG |
| 135 | Malawi | MW |
| 136 | Malaysia | MY |
| 137 | Maldives | MV |
| 138 | Mali | ML |
| 139 | Malta | MT |
| 140 | Marshall Islands (the) | MH |
| 141 | Martinique | MQ |
| 142 | Mauritania | MR |
| 143 | Mauritius | MU |
| 144 | Mayotte | YT |
| 145 | Mexico | MX |
| 146 | Micronesia (Federated States of) | FM |
| 147 | Moldova (the Republic of) | MD |
| 148 | Monaco | MC |
| 149 | Mongolia | MN |
| 150 | Montenegro | ME |
| 151 | Montserrat | MS |
| 152 | Morocco | MA |
| 153 | Mozambique | MZ |
| 154 | Myanmar | MM |
| 155 | Namibia | NA |
| 156 | Nauru | NR |
| 157 | Nepal | NP |
| 158 | Netherlands (the) | NL |
| 159 | New Caledonia | NC |
| 160 | New Zealand | NZ |
| 161 | Nicaragua | NI |
| 162 | Niger (the) | NE |
| 163 | Nigeria | NG |
| 164 | Niue | NU |
| 165 | Norfolk Island | NF |
| 166 | North Macedonia | MK |
| 167 | Northern Mariana Islands (the) | MP |
| 168 | Norway | NO |
| 169 | Oman | OM |
| 170 | Pakistan | PK |
| 171 | Palau | PW |
| 172 | Palestine, State of | PS |
| 173 | Panama | PA |
| 174 | Papua New Guinea | PG |
| 175 | Paraguay | PY |
| 176 | Peru | PE |
| 177 | Philippines (the) | PH |
| 178 | Pitcairn | PN |
| 179 | Poland | PL |
| 180 | Portugal | PT |
| 181 | Puerto Rico | PR |
| 182 | Qatar | QA |
| 183 | Réunion | RE |
| 184 | Romania | RO |
| 185 | Russian Federation (the) | RU |
| 186 | Rwanda | RW |
| 187 | Saint Barthélemy | BL |
| 188 | Saint Helena, Ascension and Tristan da Cunha | SH |
| 189 | Saint Kitts and Nevis | KN |
| 190 | Saint Lucia | LC |
| 191 | Saint Martin (French part) | MF |
| 192 | Saint Pierre and Miquelon | PM |
| 193 | Saint Vincent and the Grenadines | VC |
| 194 | Samoa | WS |
| 195 | San Marino | SM |
| 196 | Sao Tome and Principe | ST |
| 197 | Saudi Arabia | SA |
| 198 | Senegal | SN |
| 199 | Serbia | RS |
| 200 | Seychelles | SC |
| 201 | Sierra Leone | SL |
| 202 | Singapore | SG |
| 203 | Sint Maarten (Dutch part) | SX |
| 204 | Slovakia | SK |
| 205 | Slovenia | SI |
| 206 | Solomon Islands | SB |
| 207 | Somalia | SO |
| 208 | South Africa | ZA |
| 209 | South Georgia and the South Sandwich Islands | GS |
| 210 | South Sudan | SS |
| 211 | Spain | ES |
| 212 | Sri Lanka | LK |
| 213 | Sudan (the) | SD |
| 214 | Suriname | SR |
| 215 | Svalbard and Jan Mayen | SJ |
| 216 | Sweden | SE |
| 217 | Switzerland | CH |
| 218 | Syrian Arab Republic | SY |
| 219 | Taiwan (Province of China) | TW |
| 220 | Tajikistan | TJ |
| 221 | Tanzania, United Republic of | TZ |
| 222 | Thailand | TH |
| 223 | Timor-Leste | TL |
| 224 | Togo | TG |
| 225 | Tokelau | TK |
| 226 | Tonga | TO |
| 227 | Trinidad and Tobago | TT |
| 228 | Tunisia | TN |
| 229 | Turkey | TR |
| 230 | Turkmenistan | TM |
| 231 | Turks and Caicos Islands (the) | TC |
| 232 | Tuvalu | TV |
| 233 | Türkiye | TR |
| 234 | Uganda | UG |
| 235 | Ukraine | UA |
| 236 | United Arab Emirates (the) | AE |
| 237 | United Kingdom of Great Britain and Northern Ireland (the) | GB |
| 238 | United States Minor Outlying Islands (the) | UM |
| 239 | United States of America (the) | US |
| 240 | Uruguay | UY |
| 241 | Uzbekistan | UZ |
| 242 | Vanuatu | VU |
| 243 | Venezuela (Boliviarian Republic of) | VE |
| 244 | Veit Nam | VN |
| 245 | Virgin Islands (British) | VG |
| 246 | Virgin Islands (U.S.) | VI |
| 247 | Wallis and Futuna | WF |
| 248 | Western Sahara | EH |
| 249 | Yemen | YE |
| 250 | Zambia | ZM |
| 251 | Zimbabwe | ZW |

|     |
| --- |
| ISO 3166 |

Below is a list of changes that should be made relative to our standard documentation for country-specific addresses.

## Mexico

For Mexican addresses, you'll provide information for the `addressLineComponents` object described in the table below. These changes apply to:

- `originAddress` ✅
- `destinationAddress` ✅

In place of `street1` and `street2` fields, Mexican addresses require additional details including primary and secondary address numbers (outside and inside numbers), township name, and settlement name.

### Example address

U. Hab. Fovissste Fuentes Brotantes Edificio D-1 Depto 302 Col. Miguel Hidalgo, Tlalpan

### Mexico address details

| Shipium address element | Mexican address description |
| --- | --- |
| `addressLineComponents.streetName` | Street name<br>Ex.: `Fovisste Fuentes Brotantes` |
| `addressLineComponents.primaryAddressNumber` | Primary address number (outside number)<br>Ex.: `D-1` |
| `addressLineComponents.secondaryAddressNumber` | Secondary address number (inside number)<br>Ex.: `302` |
| `addressLineComponents.district` | District (township name)<br>Ex.:`Tlalpan` |
| `addressLineComponents.neighborhood` | Neighborhood (settlement name)<br>Ex.: `Miguel Hidalgo` |

### Mexico address sample

```json
"destinationAddress": {
  "name": "Sr. Hernández",
  "company": "ACME",
  "addressType": "commercial",
  "addressLineComponents": {
      "streetName": "Fovisste Fuentes Brotantes",
      "primaryAddressNumber": "D-1",
      "secondaryAddressNumber": "302",
      "district": "Tlalpan",
      "neighborhood": "Miguel Hidalgo"
  },
  "city": "Mexico City",
  "state": "CDMX",
  "countryCode": "MX",
  "postalCode": "14410"
}
```