Library . USPS . AddressInformationAPI

The Address Information API is used to make sure mailing addresses are correct. The API offers functionality that lets you perform city/state lookups, address validation, and zip code lookups. This can be useful for generating accurate city/state information, correcting errors in street addresses, and finding appropriate zip codes and zip+4 codes for given street addresses.

• Setup Instructions

  • To use the Choreos in this bundle, you'll need a USPS web service developer account. If you don't already have a USPS web service account, you'll need to go through a few simple steps to get up and running. First, register for your account at https://www.usps.com/business/webtools.htm. You'll receive an authorization email with a user ID, password, and a server URL for testing integration of your site/service. The Choreos will automatically use a test server URL when the Endpoint input variable is set to 'testing'. It will access the production server URL when the Endpoint input variable is set to 'production'.

    Before you can use the USPS API for production applications, you'll need to perform a quick set of tests to have your application approved. Run tests using the ID and password from your authorization email -- setting the Endpoint input variable to 'testing'. After running the Choreos using the test settings, you're ready to request access to the USPS production server by replying to your original authorization email or by calling or emailing the USPS Internet Customer Care Center. Make sure to reference your user ID in your message. When you're ready to run Choreos in the production environment, just set the Endpoint input variable to 'production'.

    Note: the United States Postal Service expressly prohibits generating large volumes of API requests for the purpose of batch processing or database cleansing. Requests to the API should be driven by individual user requests from a web site or a client software package.

• Related Links
  • USPS Developer Site
  • Web Tools Registration and Terms