Ballotpedia Data Client Documentation
  • Introduction
  • Geographic APIs
    • Getting started with geographic APIs
    • About redistricting
    • /districts
    • /officeholders
    • /election_dates
    • /elections_by_point
    • /elections_by_state
    • Practical guide
  • Rate limiting
  • Bulk data
    • Downloading bulk data via the client portal
  • Downloading bulk data via API
  • Dictionaries and Terms
    • About the Candidates data set
    • Data dictionary: Voting rules
    • Data dictionary: Officeholders
    • Data dictionary: Ballot Measures
    • Data dictionary: Candidates
    • Terms of Use
Powered by GitBook
On this page
Export as PDF
  1. Geographic APIs

/districts

Voting districts endpoint

PreviousAbout redistrictingNext/officeholders

Last updated 2 months ago

Given a latitude and longitude point, a list of voting districts will be returned in which that point (address) lies.

By default, the returned voting districts are in effect on the current date. An optional date parameter can be provided, which will show the districts which are/were in effect on that date. See the section for more details.

Required parameters: lat, long

Optional parameters: date

Example call
https://api4.ballotpedia.org/data/districts/point?lat=40.5550746&long=-74.27596989999999
Example response
{
    "success": true,
    "data": [
        {
            "id": "249",
            "name": "New Jersey District 6",
            "type": "Congress",
            "url": "https://ballotpedia.org/New_Jersey%27s_6th_Congressional_District",
            "ocdid": "ocd-division/country:us/state:nj/cd:6",
            "nces_id": null,
            "geo_id": "5001600US3406",
            "state": "NJ",
            "end_date": null
        },
        {
            "id": "542",
            "name": "New Jersey",
            "type": "State",
            "url": "https://ballotpedia.org/New_Jersey",
            "ocdid": "ocd-division/country:us/state:nj",
            "nces_id": null,
            "geo_id": "0400000US34",
            "state": "NJ",
            "end_date": null
        },
        {
            "id": "1794",
            "name": "New Jersey State Senate District 19",
            "type": "State Legislative (Upper)",
            "url": "https://ballotpedia.org/New_Jersey_State_Senate_District_19",
            "ocdid": "ocd-division/country:us/state:nj/sldu:19",
            "nces_id": null,
            "geo_id": "610U600US34019",
            "state": "NJ",
            "end_date": null
        },
        {
            "id": "5625",
            "name": "New Jersey General Assembly District 19",
            "type": "State Legislative (Lower)",
            "url": "https://ballotpedia.org/New_Jersey_General_Assembly_District_19",
            "ocdid": "ocd-division/country:us/state:nj/sldl:19",
            "nces_id": null,
            "geo_id": "620L600US34019",
            "state": "NJ",
            "end_date": null
        },
        {
            "id": "93743",
            "name": "United States",
            "type": "Country",
            "url": "https://ballotpedia.org/Federal_Politics",
            "ocdid": "ocd-division/country:us",
            "nces_id": null,
            "geo_id": "0100000US",
            "state": "US",
            "end_date": null
        }
    ],
    "message": null
}

About redistricting