The Bulk Geo Addressing API is now Coding Accuracy Support System (CASS) certified. This means the API has been evaluated and approved by the United States Postal Service (USPS) to ensure it works correctly with USPS internal systems. As part of the CASS implementation, a new header has been introduced, X-CASS-FLOW, which allows you to use the Bulk Geo Addressing API with the option to generate reports.
Header values for CASS certification:
-
If you need the 3553 report flow, set the
X-CASS-FLOWheader to with_report and provide a normal pipe-separated input file. -
You can include a
reportDetailsobject in the request body. This object can containlistProcessorName,listNameId,totalList, andmailingAddress. -
If you do not need the report flow, set the
X-CASS-FLOWheader to no_report and provide a normal pipe-separated input file. -
For the standard flow, you do not need to include the
X-CASS-FLOWheader.
To generate a report that evaluates the quality of an input address and shows how accurately and completely it matches official postal data, include the SERP_REPORT variable in the SERP validation process.
For the SERP report, you need to add the required report details, such as:
"reportDetails": {
"listProcessorName": "Precisely Software Inc.",
"mailingAddress": "123 Main St, New York, NY 10001 USA",
"postNumber" : "123213"
}