---
title: AddressValidationData Object
seo:
  title: AddressValidationData Object
  description: 'Object: AddressValidationData Object'
slug: api-reference/users/objects/address-validation-data
sidebar:
  label: AddressValidationData
search:
  tags:
    - API reference
    - Users
lastModified: '2026-04-13'
---

Represents address validation rules for a country.



```graphql
type AddressValidationData {
  countryCode: String!
  countryName: String!
  addressFormat: String!
  addressLatinFormat: String!
  allowedFields: [String!]!
  requiredFields: [String!]!
  upperFields: [String!]!
  countryAreaType: String!
  countryAreaChoices: [ChoiceValue!]!
  cityType: String!
  cityChoices: [ChoiceValue!]!
  cityAreaType: String!
  cityAreaChoices: [ChoiceValue!]!
  postalCodeType: String!
  postalCodeMatchers: [String!]!
  postalCodeExamples: [String!]!
  postalCodePrefix: String!
}
```


## Fields

### countryCode [#country-code]

**`countryCode`** · [`String!`](/api-reference/miscellaneous/scalars/string)

The country code of the address validation rule.
### countryName [#country-name]

**`countryName`** · [`String!`](/api-reference/miscellaneous/scalars/string)

The country name of the address validation rule.
### addressFormat [#address-format]

**`addressFormat`** · [`String!`](/api-reference/miscellaneous/scalars/string)

The address format of the address validation rule.

Many fields in the JSON refer to address fields by one-letter abbreviations. These are defined as follows:

- `N`: Name
- `O`: Organization
- `A`: Street Address Line(s)
- `D`: Dependent locality (may be an inner-city district or a suburb)
- `C`: City or Locality
- `S`: Administrative area such as a state, province, island etc
- `Z`: Zip or postal code
- `X`: Sorting code

[Click here for more information.](https://github.com/google/libaddressinput/wiki/AddressValidationMetadata)
### addressLatinFormat [#address-latin-format]

**`addressLatinFormat`** · [`String!`](/api-reference/miscellaneous/scalars/string)

The latin address format of the address validation rule.

Many fields in the JSON refer to address fields by one-letter abbreviations. These are defined as follows:

- `N`: Name
- `O`: Organization
- `A`: Street Address Line(s)
- `D`: Dependent locality (may be an inner-city district or a suburb)
- `C`: City or Locality
- `S`: Administrative area such as a state, province, island etc
- `Z`: Zip or postal code
- `X`: Sorting code

[Click here for more information.](https://github.com/google/libaddressinput/wiki/AddressValidationMetadata)
### allowedFields [#allowed-fields]

**`allowedFields`** · [`[String!]!`](/api-reference/miscellaneous/scalars/string)

The allowed fields to use in address.
### requiredFields [#required-fields]

**`requiredFields`** · [`[String!]!`](/api-reference/miscellaneous/scalars/string)

The required fields to create a valid address.
### upperFields [#upper-fields]

**`upperFields`** · [`[String!]!`](/api-reference/miscellaneous/scalars/string)

The list of fields that should be in upper case for address validation rule.
### countryAreaType [#country-area-type]

**`countryAreaType`** · [`String!`](/api-reference/miscellaneous/scalars/string)

The formal name of the county area of the address validation rule.
### countryAreaChoices [#country-area-choices]

**`countryAreaChoices`** · [`[ChoiceValue!]!`](/api-reference/miscellaneous/objects/choice-value)

The available choices for the country area of the address validation rule.
### cityType [#city-type]

**`cityType`** · [`String!`](/api-reference/miscellaneous/scalars/string)

The formal name of the city of the address validation rule.
### cityChoices [#city-choices]

**`cityChoices`** · [`[ChoiceValue!]!`](/api-reference/miscellaneous/objects/choice-value)

The available choices for the city of the address validation rule.
### cityAreaType [#city-area-type]

**`cityAreaType`** · [`String!`](/api-reference/miscellaneous/scalars/string)

The formal name of the city area of the address validation rule.
### cityAreaChoices [#city-area-choices]

**`cityAreaChoices`** · [`[ChoiceValue!]!`](/api-reference/miscellaneous/objects/choice-value)

The available choices for the city area of the address validation rule.
### postalCodeType [#postal-code-type]

**`postalCodeType`** · [`String!`](/api-reference/miscellaneous/scalars/string)

The formal name of the postal code of the address validation rule.
### postalCodeMatchers [#postal-code-matchers]

**`postalCodeMatchers`** · [`[String!]!`](/api-reference/miscellaneous/scalars/string)

The regular expression for postal code validation.
### postalCodeExamples [#postal-code-examples]

**`postalCodeExamples`** · [`[String!]!`](/api-reference/miscellaneous/scalars/string)

The example postal code of the address validation rule.
### postalCodePrefix [#postal-code-prefix]

**`postalCodePrefix`** · [`String!`](/api-reference/miscellaneous/scalars/string)

The postal code prefix of the address validation rule.

## Used by

- [addressValidationRules (queries)](/api-reference/users/queries/address-validation-rules)

---

Schema: **Saleor 3.23.43**. [Download SDL](/schema/saleor.graphql).
