Skip to main content
The Address Quality Index (AQI) is used to indicate the quality of an address, e.g., Excellent quality, Good quality, Average quality, Poor quality, and Bad quality. Any record that is able to be parsed will have an AQI. The AQI is derived from the AVC, using the following table:
AQIAddress QualityExplanationVerification levelMatchscore
AExcellentVerifiable to at least Premise level without changes>=4100
BGoodVerifiable to at least Thoroughfare level with minor changes>=3>=95
CAverageVerifiable to at least Locality level with moderate changes>=2>=90
DPoorOnly verifiable to at least Locality level with more than moderate changes>=2>=80
EBadelseelse

​
Example: Excellent Quality

{
   "Address1":"999 Baker Way, San Mateo, CA, 94404, US"
}​
The address is verified to the Premise level without changes. From the output below, we can see the post-processed verification match level is 4, and the Matchscore is 100, the Address Quality Index is A. 
{
   "AQI":"A",
   "AVC":"V44-I44-P7-100",
   "Address":"999 Baker Way, San Mateo CA 94404-1578",
   "Address1":"999 Baker Way",
   "Address2":"San Mateo CA 94404-1578",
   "AdministrativeArea":"CA",
   "CountryName":"United States",
   "DeliveryAddress":"999 Baker Way",
   "DeliveryAddress1":"999 Baker Way",
   "ISO3166-2":"US",
   "ISO3166-3":"USA",
   "ISO3166-N":"840",
   "Locality":"San Mateo",
   "MatchRuleLabel":"1",
   "PostalCode":"94404-1578",
   "PostalCodePrimary":"94404",
   "PostalCodeSecondary":"1578",
   "Premise":"999",
   "PremiseNumber":"999",
   "SubAdministrativeArea":"San Mateo",
   "Thoroughfare":"Baker Way"
}

​
Example: Good Quality

{
   "Address1":"Rua Jose Iziboro Bizetto 158, Curitiba, 81200-240, Brazil"
}
The address is verified to the Premise level with small change. The post-processed verification match level is 4, the Matchscore is 96, and an AQI “B” is returned. 
{
   "AQI":"B",
   "AVC":"V42-I44-P6-096",
   "Address":"Rua Jos\u00e9 Izidoro Biazetto 158, Mossungu\u00ea, 81200-240 Curitiba PR",
   "Address1":"Rua Jos\u00e9 Izidoro Biazetto 158",
   "Address2":"Mossungu\u00ea",
   "Address3":"81200-240 Curitiba PR",
   "AdministrativeArea":"PR",
   "CountryName":"Brazil",
   "DeliveryAddress":"Rua Jos\u00e9 Izidoro Biazetto 158, Mossungu\u00ea",
   "DeliveryAddress1":"Rua Jos\u00e9 Izidoro Biazetto 158",
   "DeliveryAddress2":"Mossungu\u00ea",
   "DependentLocality":"Mossungu\u00ea",
   "ISO3166-2":"BR",
   "ISO3166-3":"BRA",
   "ISO3166-N":"076",
   "Locality":"Curitiba",
   "MatchRuleLabel":"3",
   "PostalCode":"81200-240",
   "PostalCodePrimary":"81200-240",
   "Premise":"158",
   "PremiseNumber":"158",
   "Thoroughfare":"Rua Jos\u00e9 Izidoro Biazetto"
}

​
Example: Average Quality

{
   "Address1":"80 Rama 2 Rd , Bangkok, 10150, Thailand"
}
The address is only verified to the Locality level, the post-processed verification match level is 2, and an AQI “C” is expected. 
{
   "AQI":"C",
   "AVC":"P22-I44-P6-100",
   "Address":"80 Rama 2 Road, Samae Dam, Bang Khun Thian, Bangkok, 10150",
   "Address1":"80 Rama 2 Road",
   "Address2":"Samae Dam",
   "Address3":"Bang Khun Thian",
   "Address4":"Bangkok",
   "Address5":"10150",
   "AdministrativeArea":"Bangkok",
   "CountryName":"Thailand",
   "DeliveryAddress":"80 Rama 2 Road, Samae Dam",
   "DeliveryAddress1":"80 Rama 2 Road",
   "DeliveryAddress2":"Samae Dam",
   "DependentLocality":"Samae Dam",
   "ISO3166-2":"TH",
   "ISO3166-3":"THA",
   "ISO3166-N":"764",
   "Locality":"Bang Khun Thian",
   "MatchRuleLabel":"2",
   "PostalCode":"10150",
   "PostalCodePrimary":"10150",
   "Premise":"80",
   "PremiseNumber":"80",
   "Thoroughfare":"Rama 2 Road",
   "ThoroughfareName":"Rama 2",
   "ThoroughfareTrailingType":"Road",
   "ThoroughfareType":"Road"
}

​
Example: Poor Quality

{
   "Address1":"Hong Kong Blvd 108, HongKong, HK"
}
The address is verified to the Thoroughfare level, however the Matchscore 81 is greater than 80, and an AQI “D” is returned. 
{
   "AQI":"D",
   "AVC":"A32-I44-P0-081",
   "Address":"108 Hong Kong-Macau Ferry, Central & Western, Hong Kong",
   "Address1":"108 Hong Kong-Macau Ferry",
   "Address2":"Central & Western",
   "Address3":"Hong Kong",
   "CountryName":"Hong Kong",
   "DeliveryAddress":"108 Hong Kong-Macau Ferry, Central & Western",
   "DeliveryAddress1":"108 Hong Kong-Macau Ferry",
   "DeliveryAddress2":"Central & Western",
   "DependentLocality":"Central & Western",
   "ISO3166-2":"HK",
   "ISO3166-3":"HKG",
   "ISO3166-N":"344",
   "Locality":"Hong Kong",
   "MatchRuleLabel":"2",
   "Premise":"108",
   "PremiseNumber":"108",
   "SuperAdministrativeArea":"Hong Kong",
   "Thoroughfare":"Hong Kong-Macau Ferry",
   "ThoroughfareName":"Hong Kong",
   "ThoroughfareTrailingType":"Boulevard",
   "ThoroughfareType":"Boulevard"
}

​
Example: Poor Quality

{
   "Address1":"2010 Rutter St, Irving, TX, 75015, US"
}
The address is verified to the Locality level, the Matchscore is 87, and the Address Quality Index is D. 
{
   "AQI":"D",
   "AVC":"P22-I44-P4-087",
   "Address":"2010 Rutter St, Irving TX 75061",
   "Address1":"2010 Rutter St",
   "Address2":"Irving TX 75061",
   "AdministrativeArea":"TX",
   "CountryName":"United States",
   "DeliveryAddress":"2010 Rutter St",
   "DeliveryAddress1":"2010 Rutter St",
   "ISO3166-2":"US",
   "ISO3166-3":"USA",
   "ISO3166-N":"840",
   "Locality":"Irving",
   "MatchRuleLabel":"4",
   "PostalCode":"75061",
   "PostalCodePrimary":"75061",
   "Premise":"2010",
   "PremiseNumber":"2010",
   "SubAdministrativeArea":"Dallas",
   "Thoroughfare":"Rutter St",
   "ThoroughfareName":"Rutter",
   "ThoroughfareTrailingType":"St",
   "ThoroughfareType":"St"
}

​
Example: Bad Quality

{
   "Address1":"Bahea Blanca 4194, Villa Devoto, C1419BAL, ARG"
}
The Matchscore of this address is returned at 75, which is less than 80 that is the minimum Matchscore for AQI “D”, and an AQI “E” is expected. 
{
   "AQI":"E",
   "AVC":"V42-I44-P6-075",
   "Address":"Bah\u00eda Blanca 4194, Villa Devoto, C1419BAL Ciudad Aut\u00f3noma Buenos Aires",
   "Address1":"Bah\u00eda Blanca 4194",
   "Address2":"Villa Devoto",
   "Address3":"C1419BAL Ciudad Aut\u00f3noma Buenos Aires",
   "AdministrativeArea":"Ciudad Aut\u00f3noma de Buenos Aires",
   "CountryName":"Argentina",
   "DeliveryAddress":"Bah\u00eda Blanca 4194, Villa Devoto",
   "DeliveryAddress1":"Bah\u00eda Blanca 4194",
   "DeliveryAddress2":"Villa Devoto",
   "DependentLocality":"Villa Devoto",
   "ISO3166-2":"AR",
   "ISO3166-3":"ARG",
   "ISO3166-N":"032",
   "Locality":"Ciudad Aut\u00f3noma Buenos Aires",
   "MatchRuleLabel":"2",
   "PostalCode":"C1419BAL",
   "PostalCodePrimary":"C1419",
   "PostalCodeSecondary":"BAL",
   "Premise":"4194",
   "PremiseNumber":"4194",
   "Thoroughfare":"Bah\u00eda Blanca"
}