Address Verification Requests & Response Codes

Here is an example of our phone verification service API URL:
address verification api request

You would simply replace the highlighted data with the information you want to verify, and your own personal account’s API key and trusted domain. It is also important to identify if you want your response results to come back in XML or JSON format.

Each Parameter in the Address Validation API Request
1. Address (required): This parameter contains the address you want to verify
2. City (optional): You can supply city in the API call but it is not necessary
3. State (optional): You can supply the state in the API call but it is not necessary
4. Zip (required): The 5 digit zip code is required
5. Type (required): You can set the type to either JSON or XML
6. APIkey (required): This is where you insert your API key. You must have an account with us to get access to your APIkey
7. Domain (required): This is where you insert your trusted domain. If you make an API call with an unauthorized domain you will get a 503 error unless tests are available
8. Secret Key (optional): You can use the secret key to add new trusted domains via the API, this is mostly used by our reseller clients.

Each Tag in the Address Validation Response

postal verification

  • <address>
    The responses for address verification
  • <error>
    This helps you identify if there was an error with your request. When this tag displays “0” then there is no error. Anything else in this tag will indicate there is a problem with the request.
  • <status>
    This tag lets you know if the address supplied was either valid or invalid.
  • <response code>
    The response code helps you identify the results of your request after you verify a mailing address.
  • <message>
    The message tag helps provide more details that help explain the response code.
  • <duration>
    This tag indicates the total execution time for the request.
  • <address1>
    The house/business number and street name as well as suite/apt number if available.
  • <street>
    The house/business number and street name as well as suite/apt number if available.
  • <zip>This is the 5 digit zip code for your mailing address
  • <city>The city associated to the zip code
  • <state>The state the zip code is linked to

Response Codes:

0 = Valid Address
1 = The postal code is inaccurate
2 = An exact street name could not be found, and no similar streets were found.
3 = Suffix field does not match the postal database or more than one option was returned.
4 = The location exists, but there are no homes on this street.
5 = Address matched to multiple records.
6 = The address has been identified in the Early Warning System (EWS) data file and should be included in the next postal database update.
7 = Minimum required input is not complete. Make sure you have supplied Address and zip code.
8 = The street address was found but the suite number is not valid.
9 = The street address was found but the required suite number is missing.
10 = The street number in the input address is not valid
11 = The street number in the input address is missing
12 = The input address PO, RR, HC number is invalid.
13 = The input address is missing a PO, RR, or HC box number
14 = Address matched to a CMRA address but the secondary mailbox number is missing.
17 = A suite number was entered but no suite information found at this address.
20 = PO BOX not accepted
21 = IP address blocked, country is not allowed