VIP Specification: CandidateContest

list: Return all positions for upcoming elections.

retrieve: Return a position proposal for an upcoming election.

GET /api/positions/65257/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "url": "http://michiganelections.io/api/positions/65257/?format=api",
    "id": 65257,
    "name": "Mayor",
    "description": "Responsible for hiring and firing staff, may have veto power and is responsible for implementing legislation passed by the council. Responsible for ceremonial duties, some cities give the mayor legislative power as well.",
    "description_edit_url": "https://github.com/citizenlabsgr/elections-api/edit/main/content/positions/Mayor.md",
    "reference_url": null,
    "section": "Nonpartisan",
    "seats": 1,
    "term": "",
    "candidates": [
        {
            "url": "http://michiganelections.io/api/candidates/113494/?format=api",
            "id": 113494,
            "name": "Margaret M. Doud",
            "description": "",
            "reference_url": "https://cfrsearch.nictusa.com/committees/66127",
            "party": {
                "url": "http://michiganelections.io/api/parties/5/?format=api",
                "id": 5,
                "name": "Nonpartisan",
                "color": "#999"
            }
        }
    ],
    "election": {
        "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
    },
    "district": {
        "url": "http://michiganelections.io/api/districts/480/?format=api",
        "id": 480,
        "category": "Jurisdiction",
        "name": "City of Mackinac Island"
    }
}