Address Handling

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

Country

Field Name

Required

Restrictions/Notes

Country

Field Name

Required

Restrictions/Notes

Australia

propertyName

No*

 

Australia

flatNumber

No

Less than 256 characters

Australia

streetNumber

Yes

Less than 256 characters

Australia

streetName

Yes

Less than 256 characters

Australia

streetType

No

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

Less than 256 characters

Australia

suburb

Yes

Less than 256 characters

Australia

postcode

Yes

Must be 4 digits

Australia

state

Yes

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

Australia

country

Yes

*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

Country

Field Name

Required

Restrictions/Notes

Country

Field Name

Required

Restrictions/Notes

GB

flatNumber

No

 

GB

streetNumber

Conditional

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

GB

propertyName

Conditional

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

GB

streetName

Yes

 

GB

postcode

Yes

Valid format:

  • A1 1AA

  • A11 1AA

  • AA1 1AA

  • AA11 1AA

  • A1A 1AA

  • AA1A 1AA

  • A11AA

  • A111AA

  • AA11AA

  • AA111AA

  • A1A1AA

  • AA1A1AA

GB

country

Yes

 

New Zealand

Country

Field Name

Required

Restrictions/Notes

Country

Field Name

Required

Restrictions/Notes

New Zealand

flatNumber

No

 

New Zealand

streetNumber

Yes

 

New Zealand

streetName

Yes

 

New Zealand

streetType

No

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

otherwise it will be discarded.

New Zealand

suburb

No

 

New Zealand

postcode

Yes

Must be 4 digits

New Zealand

townCity

Yes

 

New Zealand

country

Yes

Must be NZ

Singapore

Country

Field Name

Required

Restrictions/Notes

Country

Field Name

Required

Restrictions/Notes

Singapore

streetNumber

Yes

Block/house number e.g. 123

Singapore

streetName

Yes

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

Singapore

flatNumber

No

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

Singapore

postcode

Yes

Must be 6 digits

Singapore

country

Yes

Must be SG

South Africa

Country

Field Name

Required

Restrictions/Notes

Country

Field Name

Required

Restrictions/Notes

South Africa

flatNumber

No

(equivalent to Complex Number and/or Complex Name)

South Africa

streetNumber

Yes

 

South Africa

streetName

Yes

 

South Africa

streetType

No

 

South Africa

suburb

Conditional

Either <city> or <suburb> has to be supplied to achieve an address match.

South Africa

city

Conditional

Either <city> or <suburb> has to be supplied to achieve an address match.

South Africa

postcode

Yes

Must be 4 digits

South Africa

country

Yes

Must be ZA