Interpreting Results

The Results field returned back by the service will tell all the status, error and change information about the output address returned back to you. They are returned as a comma-delimited string of 4-character alpha-numeric codes, e.g. AC02,AS01 or AE01.

The results are split into four main categories:

AV Codes	AV2X denotes an address that has been verified to the highest possible level with the reference data. AV1X denotes a partially verified address, but NOT to the highest level possible with the reference data. The second number indicates the level of verification. There are five levels:
AE Codes	These are error codes that will tell you what type of error we encountered.
AC Codes	These are change codes that will tell you which address pieces we changed from the input to the output. They include field that were blank in the input and added in the output.
GS & GE Codes	For the users who get geocoding information, this will tell you to what precision level the latitude and longitude appended are.

SE## and GE## Codes

The SE## and GE## codes (Transmission Service Error and General Transmission Error) are used to signify more general errors, and are returned under the key TransmissionResults in the outermost level of our responses.

Using Result Codes Programmatically

The concept behind the result codes are that the service will include a full list of delimited result codes, many of which may not be important to you. As a user, you should decide what codes define a good address for you and use a string.Contains search to look for those codes. If you find it, you have a good address. If you don’t, then you have a bad address. You can also cascade them into 3 or more condition layers. Here is a common example:

Result Code Cloud API Error Example:

If(Results.Contains("AV23") or Results.Contains("AV24") or Results.Contains("AV25"))
{ /*Handle Good Address*/ }
Else if(Results.Contains("AV22") or Results.Contains("AV14") or Results.Contains("AV13"))
{ /*Handle Suspect Address*/ }
Else
{ /*Handle Bad Address*/ }

Code	Description	Recommendation
AS09	|AS09-D|	Contact your CSR to add new countries.
AV25	|AV25-D|	Good
AV24	|AV24-D|	Good
AV23	|AV23-D|	Good
AV22	|AV22-D|	Medium. Only locality data was available, odds on quality is dependent on source of input.
AV14	|AV14-D|	Medium. Most of the address was good, just bad/missing suite.
AV13	|AV13-D|	Medium. Most of the address was good, house number not verified.
AV12	|AV12-D|	Bad. Could not verify the address but found a good locality value.
AV11	|AV11-D|	Bad. Could not verify the address but found a good administrative area value.