{"openapi":"3.0.3","info":{"title":"Volitve API","description":"Slovenian parliamentary elections (Državni zbor) results API","version":"1.0.0"},"paths":{"/api/elections":{"get":{"summary":"List all elections","operationId":"getElections","responses":{"200":{"description":"Array of elections","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"year":{"type":"integer"},"type":{"type":"string"},"isComplete":{"type":"boolean"},"lastSyncedAt":{"type":"string","nullable":true}}}}}}}}}},"/api/elections/{electionId}/seats":{"get":{"summary":"Parliament seat composition","operationId":"getSeats","parameters":[{"name":"electionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Seat composition","content":{"application/json":{"schema":{"type":"object","properties":{"totalSeats":{"type":"integer"},"parties":{"type":"array","items":{"type":"object","properties":{"partyId":{"type":"string"},"partyName":{"type":"string"},"abbreviation":{"type":"string"},"colorHex":{"type":"string"},"seats":{"type":"integer"}}}}}}}}}}}},"/api/elections/{electionId}/turnout":{"get":{"summary":"Turnout statistics","operationId":"getTurnout","parameters":[{"name":"electionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Turnout data","content":{"application/json":{"schema":{"type":"object","properties":{"eligibleVoters":{"type":"integer"},"ballotsCast":{"type":"integer"},"turnoutFraction":{"type":"number"},"validBallots":{"type":"integer"},"invalidBallots":{"type":"integer"}}}}}}}}},"/api/elections/{electionId}/territorial-overview":{"get":{"summary":"Territorial drill-down overview for the election map","operationId":"getTerritorialOverview","parameters":[{"name":"electionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"veId","in":"query","required":false,"schema":{"type":"string"}},{"name":"voId","in":"query","required":false,"schema":{"type":"string"}},{"name":"pollingStationId","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Visible map units plus the active territorial summary","content":{"application/json":{"schema":{"type":"object","properties":{"electionId":{"type":"string"},"visibleLevel":{"type":"string","enum":["VE","VO","pollingStation"]},"nationalSummary":{"type":"object"},"contextSummary":{"type":"object"},"selectedSummary":{"type":"object","nullable":true},"units":{"type":"array","items":{"type":"object"}}}}}}},"404":{"description":"Election not found"}}}},"/api/elections/{electionId}/threshold":{"get":{"summary":"Electoral threshold info (4%)","operationId":"getThreshold","parameters":[{"name":"electionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Threshold data","content":{"application/json":{"schema":{"type":"object","properties":{"thresholdPercent":{"type":"number"},"thresholdVotes":{"type":"integer"},"parties":{"type":"array","items":{"type":"object","properties":{"partyId":{"type":"string"},"partyName":{"type":"string"},"votesTotal":{"type":"integer"},"votePercent":{"type":"number"},"aboveThreshold":{"type":"boolean"}}}}}}}}}}}},"/api/elections/{electionId}/parties":{"get":{"summary":"Party results with Droop + D'Hondt seats","operationId":"getElectionParties","parameters":[{"name":"electionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Party results sorted by seats descending","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"partyId":{"type":"string"},"partyName":{"type":"string"},"partyAbbreviation":{"type":"string"},"colorHex":{"type":"string"},"votesTotal":{"type":"integer"},"votePercent":{"type":"number"},"seatsTotal":{"type":"integer"},"seatsDroop":{"type":"integer"},"seatsDhondt":{"type":"integer"}}}}}}}}}},"/api/parties/{partyId}/years":{"get":{"summary":"Multi-year results for a party","operationId":"getPartyYears","parameters":[{"name":"partyId","in":"path","required":true,"schema":{"type":"string"},"description":"Party abbreviation (lowercase)"}],"responses":{"200":{"description":"Results per election year, sorted by year descending","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"electionId":{"type":"string"},"year":{"type":"integer"},"votesTotal":{"type":"integer"},"votePercent":{"type":"number"},"seatsTotal":{"type":"integer"}}}}}}}}}},"/api/parties/{partyId}/territorial-comparison":{"get":{"summary":"VE/VO comparison between two elections","operationId":"getTerritorialComparison","parameters":[{"name":"partyId","in":"path","required":true,"schema":{"type":"string"}},{"name":"electionIdA","in":"query","required":true,"schema":{"type":"string"}},{"name":"electionIdB","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"VE and VO comparison data","content":{"application/json":{"schema":{"type":"object","properties":{"electionA":{"type":"string"},"electionB":{"type":"string"},"ve":{"type":"array","items":{"type":"object","properties":{"veId":{"type":"string"},"veName":{"type":"string"},"votesA":{"type":"integer"},"votePercentA":{"type":"number"},"votesB":{"type":"integer"},"votePercentB":{"type":"number"}}}},"vo":{"type":"array","items":{"type":"object","properties":{"voId":{"type":"string"},"voName":{"type":"string"},"veId":{"type":"string"},"votesA":{"type":"integer"},"votePercentA":{"type":"number"},"votesB":{"type":"integer"},"votePercentB":{"type":"number"}}}}}}}}},"400":{"description":"Missing required query parameters"}}}},"/api/parties/{partyId}/map-data":{"get":{"summary":"Geo map diff data between two elections","operationId":"getMapData","parameters":[{"name":"partyId","in":"path","required":true,"schema":{"type":"string"}},{"name":"electionIdA","in":"query","required":true,"schema":{"type":"string"}},{"name":"electionIdB","in":"query","required":true,"schema":{"type":"string"}},{"name":"level","in":"query","required":false,"schema":{"type":"string","enum":["VE","VO","pollingStation"],"default":"VE"}}],"responses":{"200":{"description":"Map unit diff data","content":{"application/json":{"schema":{"type":"object","properties":{"electionA":{"type":"string"},"electionB":{"type":"string"},"level":{"type":"string"},"units":{"type":"array","items":{"type":"object","properties":{"unitId":{"type":"string"},"votesA":{"type":"integer"},"votePercentA":{"type":"number"},"votesB":{"type":"integer"},"votePercentB":{"type":"number"}}}}}}}}},"400":{"description":"Missing required query parameters"}}}},"/api/parties/{partyId}/candidates":{"get":{"summary":"Candidate list for a party","operationId":"getCandidates","parameters":[{"name":"partyId","in":"path","required":true,"schema":{"type":"string"}},{"name":"electionId","in":"query","required":false,"schema":{"type":"string"},"description":"Defaults to most recent election"}],"responses":{"200":{"description":"Candidate list sorted by list position","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"candidateId":{"type":"integer"},"fullName":{"type":"string"},"electionId":{"type":"string"},"year":{"type":"integer"},"veId":{"type":"string"},"veName":{"type":"string"},"listPosition":{"type":"integer"},"gender":{"type":"string","nullable":true}}}}}}}}}},"/api/geo/ve":{"get":{"summary":"VE (volilne enote) GeoJSON","operationId":"getVeGeoJson","responses":{"200":{"description":"GeoJSON FeatureCollection for 8 volilne enote","content":{"application/geo+json":{"schema":{"type":"object"}}}}}}},"/api/geo/vo":{"get":{"summary":"VO (volilni okraji) GeoJSON","operationId":"getVoGeoJson","responses":{"200":{"description":"GeoJSON FeatureCollection for 88 volilni okraji","content":{"application/geo+json":{"schema":{"type":"object"}}}}}}}}}