VIP Specification: CandidateContest

list: Return all positions for upcoming elections.

retrieve: Return a position proposal for an upcoming election.

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

{
    "url": "http://michiganelections.io/api/positions/65269/?format=api",
    "id": 65269,
    "name": "Council Member",
    "description": "Council members vote on various zoning matters, oversee city agencies and programs to determine if and how money is being budgeted optimally, and they vote to approve the budget created by the mayor as well.",
    "description_edit_url": "https://github.com/citizenlabsgr/elections-api/edit/main/content/positions/Council%20Member.md",
    "reference_url": null,
    "section": "",
    "seats": 1,
    "term": "Partial Term Ending 11/09/2026",
    "candidates": [
        {
            "url": "http://michiganelections.io/api/candidates/113519/?format=api",
            "id": 113519,
            "name": "Desirae Simmons",
            "description": "",
            "reference_url": "https://cfrsearch.nictusa.com/committees/202415",
            "party": {
                "url": "http://michiganelections.io/api/parties/1/?format=api",
                "id": 1,
                "name": "Democratic",
                "color": "#3333FF"
            }
        },
        {
            "url": "http://michiganelections.io/api/candidates/113520/?format=api",
            "id": 113520,
            "name": "Rod Johnson",
            "description": "",
            "reference_url": "https://cfrsearch.nictusa.com/committees/202416",
            "party": {
                "url": "http://michiganelections.io/api/parties/6/?format=api",
                "id": 6,
                "name": "No Party Affiliation",
                "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/1242/?format=api",
        "id": 1242,
        "category": "Jurisdiction",
        "name": "City of Ypsilanti"
    }
}