1. Documentation
  2. API
  3. Precincts

Precincts

See examples of Precinct objects.

Precinct objects contain geographic information for individual "precincts" (i.e. areas that have the same ballot). These are the lowest-level division for elections, so they are usually fairly small areas. If you want district maps, you can use the extra=merge_geos parameter to combine precincts into a district map for a specific contest.


Attribute Format Description Example
ObjectType This object's data type. Will always be "precinct". "precinct"
String This is the unique id we assign to the Precinct. NOTE: Our precincts don't always match one-to-one with real-world precincts (read more). "a74635..."
OCD-ID or null This is the Open Civic Data Identifier (OCD-ID) for this Precinct. If there is no OCD-ID, this value will be null. "ocd-jurisdiction/country:us/..."
String This is the Election.id to which this Precinct belongs. NOTE: We create new precincts for each election, (read more). "985ukj.."
VotingInfo This object contains voting information, such as polling locations and times for this Precinct. {"polling_locations": [...], ...}
GeoJSON This is a geographic map of the precinct boundaries. {"type": "Polygon", "coordinates": [...], ...}
We may add more Precinct attributes in the future, so be able to handle unknown attributes.

{
    "type": "precinct",
    "id": "345-6",
    "ocd_id": null,
    "election_id": "123-4",
    "voting_info": {...},
    "geo": {"type": "Polygon", ...},
}

TODO