Skip to main content

AddressInfo

Standardized representation of a postal address.
The object supports international formats while enforcing consistent field lengths and validation rules.

  • countryCode must follow the ISO 3166-1 alpha-2 standard (e.g., "DK").
  • postalCode and city capture the locality information.
  • line1 is required for meaningful addresses; line2 and line3 are optional extensions and should only be used if the address naturally contains multiple lines, always in order (line1 → line2 → line3).
  • All fields are nullable, allowing partial addresses where only some information is known.
countryCodestringnullable

ISO 3166-1 alpha-2 country code

Possible values: >= 2 characters and <= 2 characters

Example: DK
postalCodestringnullable

The local postal code of the address

Possible values: non-empty and <= 16 characters

Example: 1400
citystringnullable

The city

Possible values: non-empty and <= 50 characters

Example: København
line1stringnullable

The first address line. Most address only has a singular line.

Possible values: non-empty and <= 50 characters

Example: Torvegade 45
line2stringnullable

Second address line. Only use if address contains multiple lines. Always start with line1.

Possible values: non-empty and <= 50 characters

Example: 2. th.
line3stringnullable

Third address line. Only use if address contains multiple lines. Always start with line1 and line2.

Possible values: non-empty and <= 50 characters

Example: Christianshavn
AddressInfo
{
  "countryCode": "DK",
  "postalCode": "1400",
  "city": "København",
  "line1": "Torvegade 45",
  "line2": "2. th.",
  "line3": "Christianshavn"
}