StreetPerfect Webservice Tech Notes

StreetPerfect.net is an XML Web service with a SOAP API that allows you to add verification and lookup functionality to your application that calls on the US Postal Service and Canada Post databases of StreetPerfect.net.

We’ve included some sample downloadable code to help you learn how to use StreetPerfect at the bottom of this page.

The formal Web-service description document (streetperfect.wsdl) is an XML document that defines the format of messages that StreetPerfect.net uses. The service description serves as an agreement that defines the behavior of StreetPerfect.net and instructs potential clients in how to interact with it.

StreetPerfect.net is comprised of two functions

Correct Address

CorrectAddress ensures that entered data is accurate. This webservice function checks against a current database of valid addresses to verify that the street address, postal/zip code, and city represent a real location. Even if some of the information is wrong the entries can be corrected, ensuring accurate information.

Suggest Address

SuggestAddress provides a method of rapidly collecting accurate information with minimal data entry. Valid address ranges described by the entry of a postal or zip code are returned and can easily be used to populate forms.

Developer Notes

Here is a StreetPerfect.net Developer GuideBook (PDF Format) for the StreetPerfect.Net Webservice. It includes the function definitions and the status codes.

Access the StreetPerfect.net XML description document to review the Service Description for the StreetPerfect.Net Webservice.

To reference the streetperfect.wsdl for use with a project in Microsoft Visual Studio .NET, from the Project menu in Visual Studio .NET, click Add Web Reference, and then enter http://www.streetperfect.net/webservice/streetperfect.asmx. After the page loads, click the appropriate production or staging link above, and then click Add Reference.

To reference the streetperfect.wsdl for use with a COM based application auch as VB6 which does not natively support the SOAP webservice interface. see the PocketSoap sample below. You need to build a COM object that can expose the webservice interface.

Downloadable Samples

All the samples will require a valid license key to use the web service.
You can get a Free 30 day trial licence key, or you can subscribe for a longer period.

  • Sample .NET application with source (VB.NET).
    This sample demonstrates the functions and result codes as well as the WebService interface, when using the VisualStudio.NET environment. It is a winform.Net application, that is similar to the web based Test Drive on this site.

  • Sample COM application with source (VB6).
    This sample is similar in functionality to the .NET one above. It also demonstrates the use of the PocketSoap WSDL proxy for webservice communication. The sample includes the COM interface that can be used by any COM aware application or development environment to communicate with the StreetPerfect.net web service.

  • Source for the PocketSoap Proxy (VB6) is also available. It is not needed to compile or use the sample application. You could generate the source yourself using the PocketSoap WSDL Generator.