SERP Overview
What is SERP
The Address Accuracy Software Evaluation and Recognition Program (SERP) ensures the best postage rates for your mailing list.
Platform Availability
SERP is currently available for the following platforms:
- Windows 32
- Windows 64
- Linux 32
- Linux 64
Release Information
Please note, SERP dataset expiration dates are set by the postal authority. Please ensure that you have the latest library and data installed to avoid loss of service through these products.
SERP Installation:
Please ensure Loqate is installed outside of Program Files. Even if you enable read/write permissions while inside Program Files, there may still be permissions issues. There are two methods to run SERP:
To run SERP in command line, add “SERP” to the process-list:
In batch mode, run lqtbatch with the process set as “serp”. The address accuracy report can also be generated through lqtbatch. The default output will be written to a text file titled: summary.txt. The output report name can be changed by replacing ‘mysummaryfile’ with the name of your choice. Below is a sample of the command line:
lqtbatch … -p serp … [-r mysummaryfile.txt]
To run SERP in Windows:
SERP can be invoked by calling the “verify” process while setting the server-option “CertifiedCountryList” to “CAN”; this will internally invoke the SERP process for Canadian addresses in your dataset. As we extend our certification process support to other countries, you will be able to specify the countries for which you want to run the certified process (as opposed to the Loqate “verify” process) through comma-separated list of country code values for the “CertifiedCountryList” option.
Updating SERP
To update SERP, run Install Manager following the instructions on the support site listed here.
On the data pack selection screen, select both the SERP Data and SERP Library. Please select the corresponding data and library for the platform you’re using.
Input Requirements
SERP is a certified process and requires the input addresses to be in the following format. The input headers must also match Loqate address fields, found on the support site here.
- Address1 (required)
- Address2 (optional)
- Locality (optional)
- AdministrativeArea (optional)
- PostalCode (optional)
- Country (required)
Output Fields
The following page outlines detailed information regarding the SERP Fields:
Sample Outputs
The below section displays sample results when using SERP:
- Input address example: 550 BURRARD ST RM 1230 VANCOUVER BC V6C2K2
| Result Codes | Output |
| SerpStatusEx | V |
| Questionable | Empty |
| Components | |
| Address Field | Sample Output |
| PremiseNumber | 550 |
| ThoroughfareName | BURRARD |
| ThoroughfareTrailingType | ST |
| SubBuildingType | RM |
| SubBuildingNumber | 1230 |
| Locality | VANCOUVER |
| AdministrativeArea | BC |
| PostalCodePrimary | V6C2K2 |
- Input address example: PO BOX 1200 SUCC POINTE-CLAIRE POINTE-CLAIRE QC H9R4R6
| Result Codes | Output |
| SerpStatusEx | V |
| Questionable | Empty |
| Components | |
| Address Field | Sample Output |
| PostBoxType | 1200 |
| DeliveryInstallationType | SUCC |
| DeliveryInstallationQualifierName | POINTE-CLAIRE |
| Locality | POINT-CLAIRE |
| AdministrativeArea | QC |
| PostalCodePrimary | H9R4R6 |
- Input address example: GD STN MAIN PARKSVILLE BC V9P2G2
| Result Codes | Output |
| SerpStatusEx | V |
| Questionable | Empty |
| Components | |
| Address Field | Sample Output |
| GeneralDelivery | GD |
| DeliveryInstallationType | STN |
| DeliveryInstallationQualifierName | MAIN |
| Locality | PARKSVILLE |
| AdministrativeArea | BC |
| PostalCodePrimary | V9P2G2 |
- Input address example: RR 1 LOT 89 CONC 3 MARYSTOWN NL A0E2M0
| Result Codes | Output |
| SerpStatusEx | V |
| Questionable | Empty |
| Components | |
| Address Field | Sample Output |
| RouteType | RR |
| RouteNumber | 1 |
| AdditionalContent | LOT 89 CONC |
| Locality | MARYSTOWN |
| AdministrativeArea | NL |
| PostalCodePrimary | A0E2M0 |