Table of Contents

Getting Started

What you can do with GeocodioSpreadsheet formattingFile formatsFile sizesIntersectionsAddress completionPreviewing your spreadsheetReverse geocoding

State Legislative Districts

Given an address or latitude/longitude coordinate pair, Geocodio can return information about the location's state legislative districts. You can upload a spreadsheet, or use our API.

You can download an example of the results when you add state House and Senate or Unicameral districts to a spreadsheet of addresses here or to latitude/longitude coordinates here

State legislative data returned

For states with bicameral districts:

  • State Legislative District House Name
  • State Legislative District House Number
  • State Legislative District House OCD id
  • State Legislative District House Proportion
  • State Legislative District Senate Name
  • State Legislative District Senate Number
  • State Legislative District Senate OCD id
  • State Legislative District Senate Proportion

For state with a unicameral legislature, such as Nebraska, data will be returned under a "Senate" header.

We do not currently return data for multi-member districts, but this is on our roadmap.

We do not return state legislator contact information. (This is not on our current roadmap.)


Open Civic Data Division Identifiers(OCD-IDs) are automatically returned when adding districts. These can be used to uniquely identify a district.


When geocoding by city or zip code, a proportion value is available. This number is a decimal percentage representation of how much of the district boundary that intersect with the zip code boundary (i.e. bigger number = more likely to be the correct district for citizens in that zip code).

When geocoding spreadsheets, only the district with the highest proportion is returned. To get multiple possible results, use the Geocodio API.


State legislative districts have been updated after 2020 Census redistricting.

The following states return districts prior to 2020 redistricting, until their respective cut-off dates:

  • MS: 2024-01-02
  • NJ: 2024-01-09
  • VA: 2024-01-10
  • LA: 2024-03-11
  • MT: 2025-01-06
  • NM (senate only): 2025-01-21
  • KS (senate only): 2025-01-15
  • SC (senate only): 2025-01-07

To request the updated districts early, use the stateleg-next data append in the Geocodio API.

Download an example

You can download an example spreadsheet of addresses with state House and Senate or Unicameral districts added here.

API to convert addresses or coordinates to state legislative districts

If you would prefer to programmatically integrate state legislative district data, you can see our API documentation for state legislative district appends here.


Requests are billed as geocode + state legislative info (i.e., two lookups). For example, if you have 100 addresses that you want state legislative districts for, that would count as 200 lookups.

You can calculate how much this will cost you and how long it will take here.

Copyright © 2014-2024 Dotsquare LLC, Norfolk, Virginia. All rights reserved.