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

/officeholders

Current officeholders endpoint

Given a latitude and longitude point, a list of current officeholders representing the point (address) will be returned with accompanying information and data points on the district, office, officeholder and person.

Required parameters: lat, long

Optional parameters: collections=social,contact

Example call
https://api4.ballotpedia.org/data/officeholders?long=-89.3818172&lat=43.079896&collections=contact
Example response
{
    "success": true,
    "data": [
        {
            "elected_officials": {
                "districts": [
                    {
                        "name": "Wisconsin District 2",
                        "id": 430,
                        "type": "Congress",
                        "state": "WI",
                        "offices": [
                            {
                                "id": 10859,
                                "name": "U.S. House Wisconsin District 2",
                                "type": "Representative",
                                "level": "Federal",
                                "branch": "Legislative",
                                "officeholders": [
                                    {
                                        "id": 37193,
                                        "status": "Current",
                                        "name": "Mark Pocan",
                                        "last_name": "Pocan",
                                        "url": "https://ballotpedia.org/Mark_Pocan",
                                        "partisan_affiliation": 2,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "202-225-2906",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://pocan.house.gov/",
                                                "contact_type": "Website"
                                            }
                                        ],
                                        "person_contact_information": null
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "name": "Wisconsin",
                        "id": 562,
                        "type": "State",
                        "state": "WI",
                        "offices": [
                            {
                                "id": 401,
                                "name": "Governor of Wisconsin",
                                "type": "Governor",
                                "level": "State",
                                "branch": "Executive",
                                "officeholders": [
                                    {
                                        "id": 56270,
                                        "status": "Current",
                                        "name": "Tony Evers",
                                        "last_name": "Evers",
                                        "url": "https://ballotpedia.org/Tony_Evers",
                                        "partisan_affiliation": 2,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "https://evers.wi.gov/pages/home.aspx",
                                                "contact_type": "Website"
                                            },
                                            {
                                                "contact": "eversinfo@wisconsin.gov",
                                                "contact_type": "Email"
                                            },
                                            {
                                                "contact": "608-266-1212",
                                                "contact_type": "Phone"
                                            }
                                        ],
                                        "person_contact_information": null
                                    }
                                ]
                            },
                            {
                                "id": 9723,
                                "name": "Attorney General of Wisconsin",
                                "type": "Attorney General",
                                "level": "State",
                                "branch": "Executive",
                                "officeholders": [
                                    {
                                        "id": 294103,
                                        "status": "Current",
                                        "name": "Josh Kaul",
                                        "last_name": "Kaul",
                                        "url": "https://ballotpedia.org/Josh_Kaul",
                                        "partisan_affiliation": 2,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "https://www.doj.state.wi.us/exec-profile/josh-kaul",
                                                "contact_type": "Website"
                                            },
                                            {
                                                "contact": "Josh.Kaul@doj.state.wi.us",
                                                "contact_type": "Email"
                                            },
                                            {
                                                "contact": "608-266-1221",
                                                "contact_type": "Phone"
                                            }
                                        ],
                                        "person_contact_information": null
                                    }
                                ]
                            },
                            {
                                "id": 11813,
                                "name": "U.S. Senate Wisconsin",
                                "type": "Senator",
                                "level": "Federal",
                                "branch": "Legislative",
                                "officeholders": [
                                    {
                                        "id": 53821,
                                        "status": "Current",
                                        "name": "Tammy Baldwin",
                                        "last_name": "Baldwin",
                                        "url": "https://ballotpedia.org/Tammy_Baldwin",
                                        "partisan_affiliation": 2,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "202-224-5653",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://www.baldwin.senate.gov/",
                                                "contact_type": "Website"
                                            }
                                        ],
                                        "person_contact_information": null
                                    },
                                    {
                                        "id": 48568,
                                        "status": "Current",
                                        "name": "Ronald Harold Johnson",
                                        "last_name": "Johnson",
                                        "url": "https://ballotpedia.org/Ron_Johnson_(Wisconsin)",
                                        "partisan_affiliation": 1,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "ron_johnson@ronjohnson.senate.gov",
                                                "contact_type": "Email"
                                            },
                                            {
                                                "contact": "202-224-5323",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://www.ronjohnson.senate.gov/public/",
                                                "contact_type": "Website"
                                            }
                                        ],
                                        "person_contact_information": null
                                    }
                                ]
                            },
                            {
                                "id": 21638,
                                "name": "Wisconsin Secretary of State",
                                "type": "Secretary of State",
                                "level": "State",
                                "branch": "Executive",
                                "officeholders": [
                                    {
                                        "id": 15676,
                                        "status": "Current",
                                        "name": "Douglas J. La Follette",
                                        "last_name": "Follette",
                                        "url": "https://ballotpedia.org/Douglas_La_Follette",
                                        "partisan_affiliation": 2,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "statesec@wi.gov",
                                                "contact_type": "Email"
                                            },
                                            {
                                                "contact": "608-266-8888",
                                                "contact_type": "Phone"
                                            }
                                        ],
                                        "person_contact_information": null
                                    }
                                ]
                            },
                            {
                                "id": 14513,
                                "name": "Lieutenant Governor of Wisconsin",
                                "type": "Lieutenant Governor",
                                "level": "State",
                                "branch": "Executive",
                                "officeholders": [
                                    {
                                        "id": 36064,
                                        "status": "Current",
                                        "name": "Mandela Barnes",
                                        "last_name": "Barnes",
                                        "url": "https://ballotpedia.org/Mandela_Barnes",
                                        "partisan_affiliation": 2,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "https://evers.wi.gov/ltgov/Pages/About_LG.aspx",
                                                "contact_type": "Website"
                                            },
                                            {
                                                "contact": "ltgovernor@wisconsin.gov",
                                                "contact_type": "Email"
                                            },
                                            {
                                                "contact": "608-266-3516",
                                                "contact_type": "Phone"
                                            }
                                        ],
                                        "person_contact_information": null
                                    }
                                ]
                            },
                            {
                                "id": 20865,
                                "name": "Wisconsin Superintendent of Public Instruction",
                                "type": "Superintendent of Schools",
                                "level": "State",
                                "branch": "Executive",
                                "officeholders": [
                                    {
                                        "id": 335652,
                                        "status": "Current",
                                        "name": "Jill Underly",
                                        "last_name": "Underly",
                                        "url": "https://ballotpedia.org/Jill_Underly",
                                        "partisan_affiliation": 7,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "608-520-0547",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://dpi-transition.wi.gov/Pages/About.aspx",
                                                "contact_type": "Website"
                                            },
                                            {
                                                "contact": "dpiinfo@dpi-transition.wi.gov",
                                                "contact_type": "Email"
                                            }
                                        ],
                                        "person_contact_information": [
                                            {
                                                "contact": "underlyforwisconsin@gmail.com",
                                                "contact_type": "Email"
                                            }
                                        ]
                                    }
                                ]
                            },
                            {
                                "id": 23727,
                                "name": "Greenfield City Council District 4",
                                "type": null,
                                "level": "Local",
                                "branch": "Legislative",
                                "officeholders": null
                            },
                            {
                                "id": 32705,
                                "name": "Milwaukee County Clerk of the Circuit Court",
                                "type": null,
                                "level": "Local",
                                "branch": "Executive",
                                "officeholders": null
                            },
                            {
                                "id": 10347,
                                "name": "Wisconsin Supreme Court",
                                "type": "Judge of court of last resort",
                                "level": "State",
                                "branch": "Judicial",
                                "officeholders": [
                                    {
                                        "id": 60167,
                                        "status": "Current",
                                        "name": "Ann Walsh Bradley",
                                        "last_name": "Bradley",
                                        "url": "https://ballotpedia.org/Ann_Walsh_Bradley",
                                        "partisan_affiliation": 7,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "608-266-1886",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://wicourts.gov/courts/supreme/justices/bradley.htm",
                                                "contact_type": "Website"
                                            }
                                        ],
                                        "person_contact_information": null
                                    },
                                    {
                                        "id": 85877,
                                        "status": "Current",
                                        "name": "Rebecca Bradley",
                                        "last_name": "Bradley",
                                        "url": "https://ballotpedia.org/Rebecca_Bradley",
                                        "partisan_affiliation": 7,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "608-266-1883",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://wicourts.gov/courts/supreme/justices/rbradley.htm",
                                                "contact_type": "Website"
                                            }
                                        ],
                                        "person_contact_information": null
                                    },
                                    {
                                        "id": 293943,
                                        "status": "Current",
                                        "name": "Rebecca Dallet",
                                        "last_name": "Dallet",
                                        "url": "https://ballotpedia.org/Rebecca_Dallet",
                                        "partisan_affiliation": 7,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "608-266-1884",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://wicourts.gov/courts/supreme/justices/dallet.htm",
                                                "contact_type": "Website"
                                            }
                                        ],
                                        "person_contact_information": null
                                    },
                                    {
                                        "id": 61839,
                                        "status": "Current",
                                        "name": "Brian Hagedorn",
                                        "last_name": "Hagedorn",
                                        "url": "https://ballotpedia.org/Brian_Hagedorn",
                                        "partisan_affiliation": 7,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "608-266-1885",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://wicourts.gov/courts/supreme/justices/hagedorn.htm",
                                                "contact_type": "Website"
                                            }
                                        ],
                                        "person_contact_information": null
                                    },
                                    {
                                        "id": 96029,
                                        "status": "Current",
                                        "name": "Jill Karofsky",
                                        "last_name": "Karofsky",
                                        "url": "https://ballotpedia.org/Jill_Karofsky",
                                        "partisan_affiliation": 7,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "608-266-1882",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://www.wicourts.gov/courts/supreme/justices/karofsky.htm",
                                                "contact_type": "Website"
                                            }
                                        ],
                                        "person_contact_information": null
                                    },
                                    {
                                        "id": 84124,
                                        "status": "Current",
                                        "name": "Patience Drake Roggensack",
                                        "last_name": "Roggensack",
                                        "url": "https://ballotpedia.org/Patience_Roggensack",
                                        "partisan_affiliation": 7,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "608-266-1888",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://wicourts.gov/courts/supreme/justices/roggensack.htm",
                                                "contact_type": "Website"
                                            }
                                        ],
                                        "person_contact_information": null
                                    },
                                    {
                                        "id": 60263,
                                        "status": "Current",
                                        "name": "Annette Ziegler",
                                        "last_name": "Ziegler",
                                        "url": "https://ballotpedia.org/Annette_Ziegler",
                                        "partisan_affiliation": 7,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "annette.ziegler@wicourts.gov",
                                                "contact_type": "Email"
                                            },
                                            {
                                                "contact": "608-266-1881",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://wicourts.gov/courts/supreme/justices/ziegler.htm",
                                                "contact_type": "Website"
                                            }
                                        ],
                                        "person_contact_information": null
                                    }
                                ]
                            },
                            {
                                "id": 7210,
                                "name": "Wisconsin Treasurer",
                                "type": "Treasurer",
                                "level": "State",
                                "branch": "Executive",
                                "officeholders": [
                                    {
                                        "id": 298061,
                                        "status": "Current",
                                        "name": "Sarah Godlewski",
                                        "last_name": "Godlewski",
                                        "url": "https://ballotpedia.org/Sarah_Godlewski",
                                        "partisan_affiliation": 2,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "https://statetreasurer.wi.gov/Pages/About-Sarah.aspx",
                                                "contact_type": "Website"
                                            },
                                            {
                                                "contact": "608-266-1714",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "Treasurer@wisconsin.gov",
                                                "contact_type": "Email"
                                            }
                                        ],
                                        "person_contact_information": null
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "name": "Wisconsin State Senate District 26",
                        "id": 2452,
                        "type": "State Legislative (Upper)",
                        "state": "WI",
                        "offices": [
                            {
                                "id": 28870,
                                "name": "Wisconsin State Senate District 26",
                                "type": "Senator",
                                "level": "State",
                                "branch": "Legislative",
                                "officeholders": [
                                    {
                                        "id": 31647,
                                        "status": "Current",
                                        "name": "Kelda Roys",
                                        "last_name": "Roys",
                                        "url": "https://ballotpedia.org/Kelda_Roys",
                                        "partisan_affiliation": 2,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "608-266-1627",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://docs.legis.wisconsin.gov/2021/legislators/senate/2252",
                                                "contact_type": "Website"
                                            },
                                            {
                                                "contact": "sen.roys@legis.wisconsin.gov",
                                                "contact_type": "Email"
                                            }
                                        ],
                                        "person_contact_information": null
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "name": "Wisconsin State Assembly District 76",
                        "id": 7302,
                        "type": "State Legislative (Lower)",
                        "state": "WI",
                        "offices": [
                            {
                                "id": 11319,
                                "name": "Wisconsin State Assembly District 76",
                                "type": "Representative",
                                "level": "State",
                                "branch": "Legislative",
                                "officeholders": [
                                    {
                                        "id": 330225,
                                        "status": "Current",
                                        "name": "Francesca Hong",
                                        "last_name": "Hong",
                                        "url": "https://ballotpedia.org/Francesca_Hong",
                                        "partisan_affiliation": 2,
                                        "officeholder_contact_information": [
                                            {
                                                "contact": "608-266-5342",
                                                "contact_type": "Phone"
                                            },
                                            {
                                                "contact": "https://docs.legis.wisconsin.gov/2021/legislators/assembly/2261",
                                                "contact_type": "Website"
                                            },
                                            {
                                                "contact": "rep.hong@legis.wisconsin.gov",
                                                "contact_type": "Email"
                                            }
                                        ],
                                        "person_contact_information": null
                                    }
                                ]
                            }
                        ]
                    },
                    {
                        "name": "Dane",
                        "id": 13889,
                        "type": "County",
                        "state": "WI",
                        "offices": null
                    },
                    {
                        "name": "Madison Metropolitan School District",
                        "id": 28168,
                        "type": "School District",
                        "state": "WI",
                        "offices": null
                    },
                    {
                        "name": "Wisconsin Court of Appeals District IV",
                        "id": 63613,
                        "type": "Judicial District",
                        "state": "WI",
                        "offices": null
                    },
                    {
                        "name": "Dane County Circuit Court, Wisconsin",
                        "id": 63626,
                        "type": "Judicial District",
                        "state": "WI",
                        "offices": null
                    },
                    {
                        "name": "Madison",
                        "id": 92584,
                        "type": "City-town",
                        "state": "WI",
                        "offices": null
                    },
                    {
                        "name": "Madison City Council District 2",
                        "id": 95104,
                        "type": "City-town subdivision",
                        "state": "WI",
                        "offices": null
                    },
                    {
                        "name": "Dane County Supervisor District 2",
                        "id": 95124,
                        "type": "County subdivision",
                        "state": "WI",
                        "offices": null
                    },
                    {
                        "name": "Sanders County Sewer District at Paradise",
                        "id": 99105,
                        "type": "Special district subdivision",
                        "state": null,
                        "offices": null
                    }
                ]
            }
        }
    ],
    "message": null
}
Previous/districtsNext/election_dates

Last updated 2 months ago