VIP Specification: Election

list: Return all upcoming elections.

retrieve: Return a specific upcoming election.

GET /api/elections/?format=api
HTTP 200 OK
Allow: OPTIONS, GET
Content-Type: application/json
Vary: Accept

{
    "count": 24,
    "next": null,
    "previous": null,
    "results": [
        {
            "url": "http://michiganelections.io/api/elections/56/?format=api",
            "id": 56,
            "name": "May Consolidated",
            "date": "2024-05-07",
            "date_humanized": "Tuesday, May 7th",
            "active": true,
            "proposals_count": 107,
            "positions_count": 19,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/55/?format=api",
            "id": 55,
            "name": "Special General",
            "date": "2024-04-16",
            "date_humanized": "Tuesday, April 16th",
            "active": true,
            "proposals_count": 1,
            "positions_count": 2,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/54/?format=api",
            "id": 54,
            "name": "Presidential Primary",
            "date": "2024-02-27",
            "date_humanized": "Tuesday, February 27th",
            "active": false,
            "proposals_count": 193,
            "positions_count": 4,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/53/?format=api",
            "id": 53,
            "name": "Special Primary",
            "date": "2024-01-30",
            "date_humanized": "Tuesday, January 30th",
            "active": false,
            "proposals_count": 1,
            "positions_count": 2,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/52/?format=api",
            "id": 52,
            "name": "November Consolidated",
            "date": "2023-11-07",
            "date_humanized": "Tuesday, November 7th",
            "active": false,
            "proposals_count": 236,
            "positions_count": 441,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/51/?format=api",
            "id": 51,
            "name": "August Consolidated",
            "date": "2023-08-08",
            "date_humanized": "Tuesday, August 8th",
            "active": false,
            "proposals_count": 125,
            "positions_count": 38,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/50/?format=api",
            "id": 50,
            "name": "May Consolidated",
            "date": "2023-05-02",
            "date_humanized": "Tuesday, May 2nd",
            "active": false,
            "proposals_count": 202,
            "positions_count": 21,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/49/?format=api",
            "id": 49,
            "name": "State General",
            "date": "2022-11-08",
            "date_humanized": "Tuesday, November 8th",
            "active": false,
            "proposals_count": 604,
            "positions_count": 3310,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/48/?format=api",
            "id": 48,
            "name": "State Primary",
            "date": "2022-08-02",
            "date_humanized": "Tuesday, August 2nd",
            "active": false,
            "proposals_count": 817,
            "positions_count": 11854,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/46/?format=api",
            "id": 46,
            "name": "May Consolidated",
            "date": "2022-05-03",
            "date_humanized": "Tuesday, May 3rd",
            "active": false,
            "proposals_count": 259,
            "positions_count": 33,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/47/?format=api",
            "id": 47,
            "name": "Special Primary",
            "date": "2022-03-01",
            "date_humanized": "Tuesday, March 1st",
            "active": false,
            "proposals_count": 0,
            "positions_count": 0,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/45/?format=api",
            "id": 45,
            "name": "November Consolidated",
            "date": "2021-11-02",
            "date_humanized": "Tuesday, November 2nd",
            "active": false,
            "proposals_count": 422,
            "positions_count": 438,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/44/?format=api",
            "id": 44,
            "name": "August Consolidated",
            "date": "2021-08-03",
            "date_humanized": "Tuesday, August 3rd",
            "active": false,
            "proposals_count": 268,
            "positions_count": 47,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/42/?format=api",
            "id": 42,
            "name": "May Consolidated",
            "date": "2021-05-04",
            "date_humanized": "Tuesday, May 4th",
            "active": false,
            "proposals_count": 405,
            "positions_count": 15,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/43/?format=api",
            "id": 43,
            "name": "Special Election",
            "date": "2021-03-23",
            "date_humanized": "Tuesday, March 23rd",
            "active": false,
            "proposals_count": 6,
            "positions_count": 0,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/41/?format=api",
            "id": 41,
            "name": "State General",
            "date": "2020-11-03",
            "date_humanized": "Tuesday, November 3rd",
            "active": false,
            "proposals_count": 671,
            "positions_count": 7807,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/40/?format=api",
            "id": 40,
            "name": "State Primary",
            "date": "2020-08-04",
            "date_humanized": "Tuesday, August 4th",
            "active": false,
            "proposals_count": 1170,
            "positions_count": 20484,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/39/?format=api",
            "id": 39,
            "name": "May Consolidated",
            "date": "2020-05-05",
            "date_humanized": "Tuesday, May 5th",
            "active": false,
            "proposals_count": 437,
            "positions_count": 11,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/38/?format=api",
            "id": 38,
            "name": "Presidential Primary",
            "date": "2020-03-10",
            "date_humanized": "Tuesday, March 10th",
            "active": false,
            "proposals_count": 527,
            "positions_count": 3,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/5/?format=api",
            "id": 5,
            "name": "November Consolidated",
            "date": "2019-11-05",
            "date_humanized": "Tuesday, November 5th",
            "active": false,
            "proposals_count": 633,
            "positions_count": 455,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/4/?format=api",
            "id": 4,
            "name": "May Consolidated",
            "date": "2019-05-07",
            "date_humanized": "Tuesday, May 7th",
            "active": false,
            "proposals_count": 0,
            "positions_count": 0,
            "reference_url": "https://www.michigan.gov/documents/sos/May_2019_Calendar_643102_7.pdf"
        },
        {
            "url": "http://michiganelections.io/api/elections/3/?format=api",
            "id": 3,
            "name": "State General",
            "date": "2018-11-06",
            "date_humanized": "Tuesday, November 6th",
            "active": false,
            "proposals_count": 932,
            "positions_count": 3618,
            "reference_url": "https://www.michigan.gov/documents/sos/2018_Dates_600221_7.pdf"
        },
        {
            "url": "http://michiganelections.io/api/elections/1/?format=api",
            "id": 1,
            "name": "State Primary",
            "date": "2018-08-07",
            "date_humanized": "Tuesday, August 7th",
            "active": false,
            "proposals_count": 187,
            "positions_count": 558,
            "reference_url": null
        },
        {
            "url": "http://michiganelections.io/api/elections/2/?format=api",
            "id": 2,
            "name": "November Consolidated",
            "date": "2017-11-07",
            "date_humanized": "Tuesday, November 7th",
            "active": false,
            "proposals_count": 0,
            "positions_count": 0,
            "reference_url": null
        }
    ]
}