When using the DataZoo API to verify individuals, you will encounter a response containing the fields "addressElement" such as Below:
"verifications": { "addressElement1": true, "addressElement3": true, "addressElement4": true, "addressElement5": true, "dateOfBirth": true, "email": true, "firstName": true, "lastName": true },
addressElement is mapped to a section of an individual's address such as their street name or city and it Will return a value of either "True" or "False" if the information provided it matches that at its data source.
Since different countries and jurisdictions contain slightly different systems for mapping address the address elements between different data sources are mapped to slightly different fields of information.
A note about addressElement1 and address Element2: In most cases the entire street address (e.g 123 Example Lane) Can be put into addressElement1 when doing an API Call and is recommended, For ease of data entry on our Web product IDU We split the street level address to be Number (addressElement1, 123) + Name (addressElement2, Example Lane) both these fields combine at a request time, i.e addressElement1 : 123 Example Lane and addressElement1: 123, addressElement2: Example lane are both interpreted as the same request. Datasources that do this are marked with (Combines with 1) below.
Please refer to the below tables for a break down of each address element by region:
Australia
addressElement | Corresponding Feild |
addressElement1 | Street Number + Street Name + Street Type |
addressElement2 | Not used |
addressElement3 | Suburb |
addressElement4 | State |
addressElement5 | PostCode |
Brazil
addressElement | Corresponding Feild |
addressElement1 | Unit No. |
addressElement2 | Street Name |
addressElement3 | Locality |
addressElement4 | District |
addressElement5 | Postcode |
Cambodia
addressElement | Corresponding Feild |
addressElement1 | Commune |
addressElement2 | District |
addressElement3 | Province |
Hong Kong
addressElement | Corresponding Feild |
addressElement1 | Unit or Flat Number |
addressElement2 | Street Address of Building |
addressElement3 | Suburb |
addressElement4 | District |
addressElement5* | Postcode |
* Note: Hong Kong doesn't use postcodes officially, It is common to either leave the postcode blank or use 0000 in hong kong when a postcode is required.
India
addressElement | Corresponding Feild |
addressElement1 | Street Number or Street Address |
addressElement2 | Street Name (combines with 1) |
addressElement3 | City |
addressElement4 | State |
addressElement5 | Postcode |
Indonesia
addressElement | Corresponding Feild |
addressElement1 | street level address (Alamat) |
addressElement2 | sub district (Kelurahan) |
addressElement5 | district/city (Kecamatan) |
Malaysia
addressElement | Corresponding Feild |
addressElement1 | Street No. |
addressElement2 | Street Name |
addressElement3 | City |
addressElement4 | State |
addressElement5 | Postcode |
New Zealand
addressElement | Corresponding Feild |
addressElement1 | Street Number, Street Address and Street Name |
addressElement2 | Not used |
addressElement3 | Suburb |
addressElement4 | City |
addressElement5 | Postcode |
Philipines
addressElement | Corresponding Feild |
addressElement1 | Street Name and Number |
addressElement2* | Barangay (Suburb or village) |
addressElement3 | City |
addressElement4 | Province |
addressElement5 | Postcode |
*Metro Manila has no Barangay so in those cases it can be left blank
Singapore
addressElement | Corresponding Feild |
addressElement1 | Street level information |
addressElement2 | Unit number and postal code |
addressElement3 | City |
addressElement4 | Country |
Vietnam
addressElement | Corresponding Feild |
addressElement1 | Street Number + Street Name + Ward + District + City |
EU + Turkey + UK and Norway
addressElement | Corresponding Feild |
addressElement1 | Street Address |
addressElement2 | Street name (Combines with 1) |
addressElement3 | City |
addressElement4 | Region or State |
addressElement5 | Postal Code |
France and Germany
addressElement | Corresponding Feild |
addressElement1 | Street Address |
addressElement2 | Street Address (Combines with 1) |
addressElement3 | City |
addressElement4 | Department/State |
addressElement5 | Postal Code |
Switzerland
addressElement | Corresponding Feild |
addressElement1 | Street Number |
addressElement2 | Street Name |
addressElement3 | City |
addressElement4 | Not used |
addressElement5 | Postal Code |
United States of America
addressElement | Corresponding Feild |
addressElement1 | Street number + Street name |
addressElement2 | Street Name (Optional Combines with 1) |
addressElement3 | Suburb |
addressElement4 | State (Two letter code eg CA for California) |
addressElement5 | Zip Code (4 Digit) |