VIP Specification: BallotStyle

list: Return all ballots for upcoming elections.

retrieve: Return a specific ballot for an upcoming election.

GET /api/ballots/?precinct_id=1173
HTTP 200 OK
Allow: OPTIONS, GET
Content-Type: application/json
Vary: Accept

{
    "count": 11,
    "next": null,
    "previous": null,
    "results": [
        {
            "url": "http://michiganelections.io/api/ballots/80697/",
            "id": 80697,
            "election": {
                "id": 58,
                "name": "State General",
                "date": "2024-11-05",
                "date_humanized": "Tuesday, November 5th",
                "active": true,
                "reference_url": null
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/50814/699/"
        },
        {
            "url": "http://michiganelections.io/api/ballots/73636/",
            "id": 73636,
            "election": {
                "id": 57,
                "name": "State Primary",
                "date": "2024-08-06",
                "date_humanized": "Tuesday, August 6th",
                "active": false,
                "reference_url": null
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/50814/698/"
        },
        {
            "url": "http://michiganelections.io/api/ballots/60191/",
            "id": 60191,
            "election": {
                "id": 52,
                "name": "November Consolidated",
                "date": "2023-11-07",
                "date_humanized": "Tuesday, November 7th",
                "active": false,
                "reference_url": null
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/50814/695/"
        },
        {
            "url": "http://michiganelections.io/api/ballots/54344/",
            "id": 54344,
            "election": {
                "id": 49,
                "name": "State General",
                "date": "2022-11-08",
                "date_humanized": "Tuesday, November 8th",
                "active": false,
                "reference_url": null
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/50814/691/"
        },
        {
            "url": "http://michiganelections.io/api/ballots/49663/",
            "id": 49663,
            "election": {
                "id": 48,
                "name": "State Primary",
                "date": "2022-08-02",
                "date_humanized": "Tuesday, August 2nd",
                "active": false,
                "reference_url": null
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/50814/690/"
        },
        {
            "url": "http://michiganelections.io/api/ballots/40808/",
            "id": 40808,
            "election": {
                "id": 44,
                "name": "August Consolidated",
                "date": "2021-08-03",
                "date_humanized": "Tuesday, August 3rd",
                "active": false,
                "reference_url": null
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/1792/686/"
        },
        {
            "url": "http://michiganelections.io/api/ballots/36722/",
            "id": 36722,
            "election": {
                "id": 41,
                "name": "State General",
                "date": "2020-11-03",
                "date_humanized": "Tuesday, November 3rd",
                "active": false,
                "reference_url": null
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/1792/683/"
        },
        {
            "url": "http://michiganelections.io/api/ballots/30312/",
            "id": 30312,
            "election": {
                "id": 40,
                "name": "State Primary",
                "date": "2020-08-04",
                "date_humanized": "Tuesday, August 4th",
                "active": false,
                "reference_url": null
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/1792/682/"
        },
        {
            "url": "http://michiganelections.io/api/ballots/27169/",
            "id": 27169,
            "election": {
                "id": 38,
                "name": "Presidential Primary",
                "date": "2020-03-10",
                "date_humanized": "Tuesday, March 10th",
                "active": false,
                "reference_url": null
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/1792/680/"
        },
        {
            "url": "http://michiganelections.io/api/ballots/20758/",
            "id": 20758,
            "election": {
                "id": 5,
                "name": "November Consolidated",
                "date": "2019-11-05",
                "date_humanized": "Tuesday, November 5th",
                "active": false,
                "reference_url": null
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/1792/679/"
        },
        {
            "url": "http://michiganelections.io/api/ballots/10665/",
            "id": 10665,
            "election": {
                "id": 3,
                "name": "State General",
                "date": "2018-11-06",
                "date_humanized": "Tuesday, November 6th",
                "active": false,
                "reference_url": "https://www.michigan.gov/documents/sos/2018_Dates_600221_7.pdf"
            },
            "precinct": {
                "url": "http://michiganelections.io/api/precincts/1173/",
                "id": 1173,
                "county": "Kent",
                "jurisdiction": "City of Grand Rapids",
                "ward": "2",
                "number": "30"
            },
            "mvic_url": "https://mvic.sos.state.mi.us/Voter/GetMvicBallot/1792/676/"
        }
    ]
}