{"name":"ElectionEngine IEC API","version":"2.4.4","supported_years":{"npe":[2009,2014,2019,2024],"lge":[2011,2016,2021,2026]},"endpoints":[{"group":"meta","method":"GET","path":"/","description":"API catalog (endpoints, descriptions, examples)","example":"/"},{"group":"meta","method":"GET","path":"/health","description":"Liveness probe (always 200 while listening; includes ready for cache warm state)","example":"/health"},{"group":"npe","method":"GET","path":"/national/:year","description":"National results (+ provincial breakdown)","example":"/national/2019"},{"group":"npe","method":"GET","path":"/provincial/:year","description":"All provincial results for a year","example":"/provincial/2019"},{"group":"npe","method":"GET","path":"/provincial/:year/:province","description":"Single province (+ municipalities)","example":"/provincial/2019/Gauteng"},{"group":"npe","method":"GET","path":"/progress/:year","description":"Counting progress for the national event","example":"/progress/2019"},{"group":"lge","method":"GET","path":"/local/:year","description":"National LGE rollup + provincial breakdown","example":"/local/2021"},{"group":"lge","method":"GET","path":"/local/:year/provinces/:province","description":"Province + municipalities (ballots + seats)","example":"/local/2021/provinces/Gauteng"},{"group":"lge","method":"GET","path":"/local/:year/provinces/:province/municipalities/:municipality","description":"Municipality detail, seats, ward list","example":"/local/2021/provinces/Gauteng/municipalities/Johannesburg"},{"group":"lge","method":"GET","path":"/local/:year/provinces/:province/municipalities/:municipality/wards/:ward","description":"Ward ballots + VD list","example":"/local/2021/provinces/Gauteng/municipalities/Johannesburg/wards/1"},{"group":"lge","method":"GET","path":"/local/:year/provinces/:province/municipalities/:municipality/voting-districts/:vd","description":"Voting-district ballots","example":"/local/2021/provinces/Gauteng/municipalities/Johannesburg/voting-districts/32850030"},{"group":"lge","method":"GET","path":"/local/:year/progress","description":"LGE counting progress","example":"/local/2021/progress"},{"group":"lge","method":"GET","path":"/local/:year/parties","description":"Contesting parties (optional scopes)","example":"/local/2021/parties?province=Gauteng","query":[{"name":"province","required":false,"description":"Province name or ID to scope parties"},{"name":"municipality","required":false,"description":"Municipality name or ID (requires province)"}]},{"group":"lge","method":"GET","path":"/local/:year/municipalities/:municipality/candidates","description":"PR list candidates","example":"/local/2021/municipalities/Johannesburg/candidates"},{"group":"lge","method":"GET","path":"/local/:year/wards/:ward/candidates","description":"Ward candidates","example":"/local/2021/wards/79800001/candidates"},{"group":"lge","method":"GET","path":"/local/:year/wards/:ward/councilor","description":"Ward councilor","example":"/local/2021/wards/79800001/councilor"},{"group":"lge","method":"GET","path":"/local/:year/councilors","description":"Councilors for the event","example":"/local/2021/councilors"},{"group":"lge","method":"GET","path":"/local/:year/latest-results","description":"Latest VD results in","example":"/local/2021/latest-results?limit=10","query":[{"name":"limit","required":false,"description":"Max results to return (default 10)"}]},{"group":"lge","method":"GET","path":"/voting-stations/:vd","description":"Voting station details by VD number","example":"/voting-stations/32850030"},{"group":"raw","method":"GET","path":"/electoral_types","description":"Raw IEC electoral types","example":"/electoral_types"},{"group":"raw","method":"GET","path":"/electoral_events/:eventTypeID","description":"Raw IEC electoral events","example":"/electoral_events/1"},{"group":"raw","method":"GET","path":"/provinces/:eventID","description":"Raw delimitations","example":"/provinces/1224"},{"group":"raw","method":"GET","path":"/results/:eventID","description":"Raw NPE ballot results","example":"/results/1224"},{"group":"raw","method":"GET","path":"/seats/:eventID","description":"Raw NPE seat calculations","example":"/seats/1224"},{"group":"maps","method":"GET","path":"/maps","description":"List available GeoJSON map assets","example":"/maps"},{"group":"maps","method":"GET","path":"/maps/*","description":"Static GeoJSON map assets","example":"/maps/2026/municipalities/JHB.json"},{"group":"maps","method":"GET","path":"/svg","description":"List available SVG map previews (derived from GeoJSON assets)","example":"/svg"},{"group":"maps","method":"GET","path":"/svg/*","description":"On-demand SVG preview rendered from the matching GeoJSON map","example":"/svg/2026/municipalities/JHB.svg?width=800","query":[{"name":"width","required":false,"description":"SVG width in pixels (32–4096, default 800)"}]},{"group":"admin","method":"GET","path":"/flush_cache","description":"Clear and re-warm Redis cache","example":"/flush_cache?api_key=YOUR_API_KEY","query":[{"name":"api_key","required":true,"description":"Shared secret matching API_KEY env var"}]}]}