What's New?

Using our Lists API endpoint, Enterprise Unlimited customers can now process spreadsheets directly via API.

If you have several large datasets of location data that you need to bulk geocode, this will save you time and effort as you won't have to upload them manually via the spreadsheet upload tool.

Please see below for how to enable the Lists API for your account and how to make calls.

Good to know

• The Lists API is available for all Enterprise Unlimited customers and is included with your subscription.
• The supported file types are CSV, TSV, XLS, and XLSX.
• Like spreadsheets uploaded through the spreadsheet upload tool, files must be downloaded within 72 hours of processing completion for security reasons.
• Bear in mind the processing capacity of your instance(s). For example, if you bulk geocode a CSV of 10 million addresses and have one instance, it will process at a rate of approximately 200,000 lookups per hour. Any additional fields count as additional lookups.

Enable the Lists API for your API keys

Before you use the Lists API with Geocodio Enterprise, you'll need to enable it as an endpoint option.

Navigate to the "API Keys" tab in your account dashboard, then click "Edit" on the API key you'd like to use.

The Edit menu will open and you'll see a list of permissions. By default, API keys only have single and batch geocoding enabled.

To enable the Lists API, click the checkboxes for the required /lists endpoints. These endpoints will allow you to create new uploads, check processing status, and delete spreadsheets. Click save to confirm.

Using the Lists API

In order to make a call to the Lists API, Enterprise Unlimited customers must send the API Key as a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Here's an example of what that would look like when creating a new list:

  curl "https://api.enterprise.geocod.io/v1.7/lists 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -F "file"="@sample_list.csv" 
  -F "direction"="forward" 
  -F "format"="{{A}} {{B}} {{C}} {{D}}" 
  -F "callback"="https://example.com/my-callback"

For more information on how to implement the Lists API, please see our documentation here.

Any questions? Please reach out to support@geocod.io and we'll be happy to help.

About Geocodio Enterprise

Geocodio Enterprise is a geocoding and data matching SaaS for the US and Canada built to meet the requirements of SOC 2 Type 2 and HIPAA. Geocodio is designed for bulk geocoding, and supports customers who need to geocode millions of addresses or coordinates — per year, month, day, or hour. Geocodio also simplifies your ETL by allowing you to add additional data in the same request, such as Census boundaries, political districts, and more. Geocodio Enterprise is used by a wide variety of companies with the highest data handling and privacy requirements, including major health insurers, financial services firms such banks and brokers, e-commerce companies, and more.