With Geocodio, you can append several different types of political and civic data to addresses in bulk. You can also lookup this information with latitude/longitude coordinates if you already have them.

  • Congressional districts: You can append current House districts for the for current 115th Congress, as well as 113th and 114th
  • State legislative districts: House and Senate districts are returned; where applicable, unicameral
  • School districts: both elementary and secondary are returned (or unified where applicable)
  • Census blocks, tracts, and FIPS codes: Gain deeper demographic insights about your addresses. These data points will help you connect  your address data to Census data.

Each of these data points is available as a separate lookup.

Converting your data

There are two ways you can add political and civic data to your addresses with Geocodio: API and spreadsheet upload.


The Geocodio API supports batches of up to 10,000 addresses/batch.

Thanks to the open source community, we have libraries for many different programming languages to make it easy for you to integrate Geocodio into your website, CRM, or application. 

To get started, you will need to create an API key. Please see our docs for further details about integrating geocoding and Congressional, state legislative, school district, and Census information.

Accounts can have multiple API keys. This can be useful if you’re working on several projects or with clients and want to track usage per API key or be revoke access for a particular project. You can also download a report of usage and fees per API key.

Upload a spreadsheet

You can also upload a spreadsheet (CSV, TSV, or Excel). This can be useful if you have a list of donor information, for example, and would like to know which districts those voters are in.

See more about uploading spreadsheets here.

Data Returned

When you submit an address for geocoding and additional data conversion, we'll return to you:

Included with all results

  • A downloadable CSV of addresses turned into lat/lon, or lat/lon turned into addresses, plus any additional data you've requested
  • A link to a map of your addresses, which you can privately or publicly share if you'd like
  • Parsed and standardized addresses
  • Accuracy scores and types for each result

Congressional districts

You can request:

  • Current Congress (115th)
  • Past Congresses (113th and 114th) -- via API only

The completed lookup will return:

  • full name of the Congressional district
  • district number
  • Congress number
  • Range of years the Congress covers

State legislative districts

You can retrieve the state legislative districts for an address or lat/lon pair. Geocodio will return:

  • House district name and number
  • Senate district name and number

For areas with a unicameral legislature (such as Washington, DC or Nebraska), the result is returned as Senate.

School districts

You can find the school district information for addresses or lat/lon pairs.

Geocodio will return:

  • Elementary and secondary, or unified if applicable
  • District full name
  • LEA (Local Education Agency) code
  • Grades supported
  • Kindergarten is abbreviated as KG and Pre-kindergarten is abbreviated as PK.

Census information

This lookup will append several different census-designated codes to your address that you can then use to match locations to statistical data from the U.S. Census Bureau. You can, for example, utilize the American Community Survey (ACS) data.

  • Census year: The full year that the Census data belongs to (The U.S. Census Bureau might make slight boundary changes from year to year) 
  • State FIPS code: The two-digit state FIPS code.
  • County FIPS code: The five-digit county FIPS code. The two first digits represents the state. 
  • Place FIPS: The 7-digit place FIPS code (ANSI). A place is defined as a city or other census designated area. A full list of ANSI codes is available from the U.S. Census Bureau.
  • Census tract code: The 6-digit census tract code. This is a subdivision of a county, used for statistical purposes. 
  • Census block code: The full 4-digit block code that the location belongs to. This is the smallest geographical unit that the U.S. Census Bureau provides statistical data for. 
  • Census block group The single-digit group number for the block.

The U.S. Census Bureau also provides a more detailed guide for the above terms.

Cost and Processing Time

Our base pricing is:

  • First 2,500/day free
  • $0.50/1,000 after that, no minimum or maximum
  • Additional data points $0.50/1,000/each

Additional data points count as an additional lookup each. So for example, if you had a list of 2,000 addresses and would like the Congressional district information for them, the total number of lookups would be 4,000.

You can see how much it will cost, and, if you're uploading a spreadsheet, how long it will take, here:

We encourage you to test out the tool before uploading a large list. You can bulk geocode a list of up to 2,500 addresses free per day without a credit card required. 

High volume

If you have a high ongoing volume and would like to pay a flat rate, consider our Geocodio Unlimited plan, which includes dedicated resources for $750 per month. With this plan, you can convert up to 200,000 addresses per hour (4.8M per day) for a flat rate. 

We also offer concierge geocoding services for lists of 10M+ if expedited processing is desired. Please contact us to discuss if so.

Security and Privacy

We understand that your data is sensitive and take steps to protect it.

Application Security

All data on the Geocodio platform (internally and externally) is transferred securely via HTTPS (with the exception of customers who explicitly decide to use the non-HTTPS API endpoint).

We utilize physical, dedicated servers — we are not sharing resources with others. We use a state of the art data center located in Germany that has strict access control with key cards and 24/7 surveillance. Our infrastructure is distributed across multiple physical data centers, operated by the same company for full redundancy.

Data Storage

When using our list upload tool: The geocoded file is stored securely with Amazon Web Services in the US. You can permanently delete the file at any time via the geocod.io dashboard.

When using our API: Some API transactions are logged for analytics and Q/A purposes. This data is never shared with third-parties. You are welcome to opt-out of the Q/A process. Please email us if you would like to opt-out of Q/A.

We do not log transactions for customers on the Unlimited plan as this service is unmetered. If you would desired complete data blindness on our part, we would suggest using this plan.

Did this answer your question?