Local API Installations

If your company has strict policies in place that prevent you from calling cloud-based web services on the internet (such as ours), you may want to consider becoming an enterprise customer, allowing you to run your own local installation of our APIs. This document details some of the prerequisites for doing this and provides links to each API's specific installation process.

Contents

  1. API Documentation
  2. Updates
  3. Requirements
  4. API Listing

API Documentation

All local installations of the Smarty (formerly SmartyStreets) APIs perform identically to the cloud-based versions hosted by Smarty with the exception that they don't require client authentication or authorization. Please refer to the documentation for each specific API for details about input and output fields.

Updates

Smarty publishes regular updates to local API packages. New releases are announced in our open-source Changelog repository.

Minimum System Requirements

The process of downloading, installing, and managing a local instance of any Smarty API requires a system administrator or software engineer who has experience with the Linux operating system and its accompanying shell environment. Responsibility for network and server maintenance (as well as the performance of all installation instructions) rests with your organization.

The server provisioned to run a local API instance should match the following criteria:

  • 8 gigabytes of RAM
  • 4 CPU cores
  • A relatively recent version of the Linux kernel (basically something that can run compiled Go programs). Anything later than v2.6.32 should function without issues.

Using this hardware configuration, you can expect to process around 1,000 addresses per second per CPU core. This estimate assumes you are calling the US Street Address API, and the server has been up and running for a few minutes.

API Listing

Installation instructions and minimum system requirements for each API:

Ready to get started?