Address Handling

All fields not named in the table/s below will be ignored by the rules engine and should not be sent to vixverify. Eg. For South Africa, 'town' can not be substituted for 'suburb' or 'city'.

Australia

CountryField NameRequiredRestrictions/Notes
AustraliapropertyNameNo*
Australia

flatNumber

No

Less than 256 characters

AustraliastreetNumberYes

Less than 256 characters

AustraliastreetNameYes

Less than 256 characters

AustraliastreetTypeNo

If present, the street type must be one of those listed at AU Street Types otherwise it will be discarded. 

Less than 256 characters

AustraliasuburbYesLess than 256 characters
AustraliapostcodeYesMust be 4 digits
AustraliastateYes

Must be one of the following: ACT NSW NT QLD SA TAS VIC WA

AustraliacountryYes*Must be AU

*While Property Name is not a required field, it should be passed in if a customer has the Electoral Roll data source configured. The source will be checked for a Property Name if it is available on the individual's address record.

GB

CountryField NameRequiredRestrictions/Notes
GB

flatNumber

No


GBstreetNumberConditional

Either <streetNumber> or <propertyName> has to be supplied to achieve an address match

GBpropertyNameConditional

Either <streetNumber> or <propertyName> has to be supplied to achieve an address match

GBstreetNameYes
GBpostcodeYes

Valid format:

  • A1 1AA
  • A11 1AA
  • AA1 1AA
  • AA11 1AA
  • A1A 1AA
  • AA1A 1AA
  • A11AA
  • A111AA
  • AA11AA
  • AA111AA
  • A1A1AA
  • AA1A1AA
GBcountryYes

New Zealand

CountryField NameRequiredRestrictions/Notes
New Zealand

flatNumber

No
New ZealandstreetNumberYes


New ZealandstreetNameYes


New ZealandstreetTypeNo

If present, the street type must be one of those listed in NZ Street Types

otherwise it will be discarded.

New ZealandsuburbNo
New ZealandpostcodeYesMust be 4 digits
New ZealandtownCityYes


New ZealandcountryYesMust be NZ

Singapore

CountryField NameRequiredRestrictions/Notes
SingaporestreetNumberYes

Block/house number e.g. 123

SingaporestreetNameYes

All street parts of an address e.g.Tampines St 33

SingaporeflatNumberNo

All unit parts of an address e.g. #13–37 Mandalay Towers 

SingaporepostcodeYesMust be 6 digits
SingaporecountryYesMust be SG

South Africa

CountryField NameRequiredRestrictions/Notes
South Africa

flatNumber

No(equivalent to Complex Number and/or Complex Name)
South AfricastreetNumberYes
South AfricastreetNameYes
South AfricastreetTypeNo
South AfricasuburbConditionalEither <city> or <suburb> has to be supplied to achieve an address match.
South AfricacityConditionalEither <city> or <suburb> has to be supplied to achieve an address match.
South AfricapostcodeYesMust be 4 digits
South AfricacountryYesMust be ZA