# Data & Validation - Address

# Address

- Object: Application - Physical address (corporation), registered address (corporation), mailing address (individual)
- Object: Customer - Physical address (corporation), registered address (corporation), mailing address (individual)
- Object: Counterparty - Counterparty address, institution address, intermediary institution address


## Countries

For countries (`country_code`) Rail uses [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 2 character country code e.g. US for United States, GB for United Kingdom.

## States

The required data type for the `state` field changes depending on the country the state resides in. Some countries require a specific enum value to be provided e.g. NY for New York if country is US (United States). However, most other countries require a string value to be provided e.g. Cork is the country is IE (Ireland).

Below is a breakdown of the state enums for each country that requires specific values. Any country NOT on this list accepts any string as a state value.

| Country | Country Enum | State data type | State | State Enum |
|  --- | --- | --- | --- | --- |
| United States | `US` | Enum | ISO 3166-2 | [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) |
| Azerbaijan | `AZ` | Enum | Kalbajar | `KALBAJAR` |
| Azerbaijan | `AZ` | Enum | Shusha | `SHUSHA` |
| Azerbaijan | `AZ` | Enum | Tartar | `TARTAR` |
| Azerbaijan | `AZ` | Enum | Khojaly | `KHOJALY` |
| Azerbaijan | `AZ` | Enum | Khojavend | `KHOJAVEND` |
| Azerbaijan | `AZ` | Enum | Absheron | `ABSHERON` |
| Azerbaijan | `AZ` | Enum | Aghjabadi | `AGHJABADI` |
| Azerbaijan | `AZ` | Enum | Aghdam | `AGHDAM` |
| Azerbaijan | `AZ` | Enum | Agdash | `AGDASH` |
| Azerbaijan | `AZ` | Enum | Aghstafa | `AGHSTAFA` |
| Azerbaijan | `AZ` | Enum | Agsu | `AGSU` |
| Azerbaijan | `AZ` | Enum | Sirvan | `SIRVAN` |
| Azerbaijan | `AZ` | Enum | Astara | `ASTARA` |
| Azerbaijan | `AZ` | Enum | Baku | `BAKU` |
| Azerbaijan | `AZ` | Enum | Balakan | `BALAKAN` |
| Azerbaijan | `AZ` | Enum | Barda | `BARDA` |
| Azerbaijan | `AZ` | Enum | Beylagan | `BEYLAGAN` |
| Azerbaijan | `AZ` | Enum | Bilasuvar | `BILASUVAR` |
| Azerbaijan | `AZ` | Enum | Jabrayil | `JABRAYIL` |
| Azerbaijan | `AZ` | Enum | Jalilabad | `JALILABAD` |
| Azerbaijan | `AZ` | Enum | Dashkasan | `DASHKASAN` |
| Azerbaijan | `AZ` | Enum | Shabran | `SHABRAN` |
| Azerbaijan | `AZ` | Enum | Fuzuli | `FUZULI` |
| Azerbaijan | `AZ` | Enum | Gadabay | `GADABAY` |
| Azerbaijan | `AZ` | Enum | Ganja | `GANJA` |
| Azerbaijan | `AZ` | Enum | Goranboy | `GORANBOY` |
| Azerbaijan | `AZ` | Enum | Goychay | `GOYCHAY` |
| Azerbaijan | `AZ` | Enum | Hajigabul | `HAJIGABUL` |
| Azerbaijan | `AZ` | Enum | Imishli | `IMISHLI` |
| Azerbaijan | `AZ` | Enum | Ismayilli | `ISMAYILLI` |
| Azerbaijan | `AZ` | Enum | Kurdamir | `KURDAMIR` |
| Azerbaijan | `AZ` | Enum | Lachin | `LACHIN` |
| Azerbaijan | `AZ` | Enum | Lankaran | `LANKARAN` |
| Azerbaijan | `AZ` | Enum | Lankaran | `LANKARAN` |
| Azerbaijan | `AZ` | Enum | Lerik | `LERIK` |
| Azerbaijan | `AZ` | Enum | Masally | `MASALLY` |
| Azerbaijan | `AZ` | Enum | Mingachevir | `MINGACHEVIR` |
| Azerbaijan | `AZ` | Enum | Naftalan | `NAFTALAN` |
| Azerbaijan | `AZ` | Enum | Neftchala | `NEFTCHALA` |
| Azerbaijan | `AZ` | Enum | Oghuz | `OGHUZ` |
| Azerbaijan | `AZ` | Enum | Qabala | `QABALA` |
| Azerbaijan | `AZ` | Enum | Qakh | `QAKH` |
| Azerbaijan | `AZ` | Enum | Qazax | `QAZAX` |
| Azerbaijan | `AZ` | Enum | Gobustan | `GOBUSTAN` |
| Azerbaijan | `AZ` | Enum | Quba | `QUBA` |
| Azerbaijan | `AZ` | Enum | Qubadli | `QUBADLI` |
| Azerbaijan | `AZ` | Enum | Qusar | `QUSAR` |
| Azerbaijan | `AZ` | Enum | Saatly | `SAATLY` |
| Azerbaijan | `AZ` | Enum | Sabirabad | `SABIRABAD` |
| Azerbaijan | `AZ` | Enum | Shaki | `SHAKI` |
| Azerbaijan | `AZ` | Enum | Shaki | `SHAKI` |
| Azerbaijan | `AZ` | Enum | Salyan | `SALYAN` |
| Azerbaijan | `AZ` | Enum | Shamakhi | `SHAMAKHI` |
| Azerbaijan | `AZ` | Enum | Shamkir | `SHAMKIR` |
| Azerbaijan | `AZ` | Enum | Samukh | `SAMUKH` |
| Azerbaijan | `AZ` | Enum | Siyazan | `SIYAZAN` |
| Azerbaijan | `AZ` | Enum | Sumgait | `SUMGAIT` |
| Azerbaijan | `AZ` | Enum | Tovuz | `TOVUZ` |
| Azerbaijan | `AZ` | Enum | Ujar | `UJAR` |
| Azerbaijan | `AZ` | Enum | Khachmaz | `KHACHMAZ` |
| Azerbaijan | `AZ` | Enum | Khankendi | `KHANKENDI` |
| Azerbaijan | `AZ` | Enum | Goygol | `GOYGOL` |
| Azerbaijan | `AZ` | Enum | Khizi | `KHIZI` |
| Azerbaijan | `AZ` | Enum | Yardimli | `YARDIMLI` |
| Azerbaijan | `AZ` | Enum | Yevlakh | `YEVLAKH` |
| Azerbaijan | `AZ` | Enum | Yevlakh | `YEVLAKH` |
| Azerbaijan | `AZ` | Enum | Zangilan | `ZANGILAN` |
| Azerbaijan | `AZ` | Enum | Zagatala | `ZAGATALA` |
| Azerbaijan | `AZ` | Enum | Zardab | `ZARDAB` |
| Cyprus | `CY` | Enum | Lefkosa | `LEFKOSA` |
| Cyprus | `CY` | Enum | Gazimagusa | `GAZIMAGUSA` |
| Cyprus | `CY` | Enum | Girne | `GIRNE` |
| Cyprus | `CY` | Enum | Guzelyurt | `GUZELYURT` |
| Cyprus | `CY` | Enum | Iskele | `ISKELE` |
| Cyprus | `CY` | Enum | Lefke | `LEFKE` |
| Cyprus | `CY` | Enum | Famagusta | `FAMAGUSTA` |
| Cyprus | `CY` | Enum | Kyrenia | `KYRENIA` |
| Cyprus | `CY` | Enum | Larnaca | `LARNACA` |
| Cyprus | `CY` | Enum | Limassol | `LIMASSOL` |
| Cyprus | `CY` | Enum | Nicosia | `NICOSIA` |
| Cyprus | `CY` | Enum | Paphos | `PAPHOS` |
| Georgia | `GE` | Enum | Tbilisi | `TBILISI` |
| Georgia | `GE` | Enum | Imereti | `IMERETI` |
| Georgia | `GE` | Enum | Ajaria | `AJARIA` |
| Georgia | `GE` | Enum | Kvemo Kartli | `KVEMO_KARTLI` |
| Georgia | `GE` | Enum | Samegrelo and Zemo Svaneti | `SAMEGRELO_ZEMO_SVANETI` |
| Georgia | `GE` | Enum | Kakheti | `KAKHETI` |
| Georgia | `GE` | Enum | Shida Kartli | `SHIDA_KARTLI` |
| Georgia | `GE` | Enum | Abkhazia | `ABKHAZIA` |
| Georgia | `GE` | Enum | Samtskhe-Javakheti | `SAMTSKHE_JAVAKHETI` |
| Georgia | `GE` | Enum | Guria | `GURIA` |
| Georgia | `GE` | Enum | Mtskheta-Mtianeti | `MTSKHETA_MTIANETI` |
| Georgia | `GE` | Enum | Racha-Lechkhumi and Kvemo Svaneti | `RACHA_LECHKHUMI_KVEMO_SVANETI` |
| Ukraine | `UA` | Enum | Autonomous Republic of Crimea | `CRIMEA` |
| Ukraine | `UA` | Enum | Sevastopol | `SEVASTOPOL` |
| Ukraine | `UA` | Enum | Luhansk | `LUHANSK` |
| Ukraine | `UA` | Enum | Donetsk | `DONETSK` |
| Ukraine | `UA` | Enum | Kherson | `KHERSON` |
| Ukraine | `UA` | Enum | Zaporizhzhia | `ZAPORIZHZHIA` |
| Ukraine | `UA` | Enum | Mykolaiv | `MYKOLAIV` |
| Ukraine | `UA` | Enum | Kharkiv | `KHARKIV` |
| Ukraine | `UA` | Enum | Sumy | `SUMY` |
| Ukraine | `UA` | Enum | Kyiv | `KYIV` |
| Ukraine | `UA` | Enum | Chernihiv | `CHERNIHIV` |
| Ukraine | `UA` | Enum | Cherkasy | `CHERKASY` |
| Ukraine | `UA` | Enum | Chernivtsi | `CHERNIVTSI` |
| Ukraine | `UA` | Enum | Dnipropetrovsk | `DNIPROPETROVSK` |
| Ukraine | `UA` | Enum | Ivano-Frankivsk | `IVANO_FRANKIVSK` |
| Ukraine | `UA` | Enum | Khmelnytskyi | `KHMELNYTSKYI` |
| Ukraine | `UA` | Enum | Kirovohrad | `KIROVOHRAD` |
| Ukraine | `UA` | Enum | Lviv | `LVIV` |
| Ukraine | `UA` | Enum | Odesa | `ODESA` |
| Ukraine | `UA` | Enum | Poltava | `POLTAVA` |
| Ukraine | `UA` | Enum | Rivne | `RIVNE` |
| Ukraine | `UA` | Enum | Ternopil | `TERNOPIL` |
| Ukraine | `UA` | Enum | Vinnytsia | `VINNYTSIA` |
| Ukraine | `UA` | Enum | Volyn | `VOLYN` |
| Ukraine | `UA` | Enum | Zakarpattia | `ZAKARPATTIA` |
| Ukraine | `UA` | Enum | Zhytomyr | `ZHYTOMYR` |