Registertovote Elections API [2024]

Developed by C.A Torino, TECHRAD Radical Technology

Links to TECHRAD ZA.

The year is 2024 and South Africa is having an election year like many other countries.

I have compiled a list of a few useful API endpoints which allows someone to:

view your current voter address.
find your voting station.

Or simply to be aware of important information like upcoming election dates in your ward.

I have not included anything which could cause security issues like:

register to vote
update your current voter address
request a special vote

For anything like that.. login to the https://registertovote.elections.org.za/Account/Login site.

This API is simply for checking stats.

Check my registration status

Check to see if you are properly registered in the correct voting station.

go to: https://maps.elections.org.za/vsfinder/

Endpoints

All work without needing to login

POST GET

WORKS after logout

{url}/IECGIS_VSFinder/api/autocomplete?
- {parameters} = input=golden%20hill&guid=a1234qdsew3r534tgfd

WORKS after logout

{url}/IECGIS_VSFinder/api/places?
- {parameters} = placeid=ChIJQarDjNJvlR4RLjGORId618Q&guid=a1234qdsew3r534tgfd

WORKS after logout

{url}/IECGIS_VSFinder/api/VotingDistrict?
- {parameters} = latitude=-25.9949273697085&longitude=28.1144585302915

WORKS after logout

{url}/IECGIS_VSFinder/api/Ward?
- {parameters} = wardid=52308012

WORKS after logout

{url}/IECGIS_VSFinder/api/Municipality?
- {parameters} = municid=79800132

WORKS after logout

{url}/IECGIS_VSFinder/api/MEO?
- {parameters} = municid=79800132

1. Search Return

Autocomplete Search return [Returns the details aboul the street address]

{url} = https://gisapi.elections.org.za

{url}/IECGIS_VSFinder/api/autocomplete?
- {parameters} = input=golden%20hill&guid=a1234qdsew3r534tgfd

Calling Parameters (Input)

Parameter	Mode	Description	example values
`input`	string	search input	golden hill
`guid`	string	unique id	a1234qdsew3r534tgfd

Interface Address

https://gisapi.elections.org.za/IECGIS_VSFinder/api/autocomplete?

Request Method

HTTP
POST

Response Parameters (Output)

Parameter	Mode	Description	example values
`status`	string	Https	OK
`description`	string	Https	Golden Hills Estate, Smuts Drive, Halfway Gardens, Midrand, South Africa
`placeid`	string	Https	ChIJQarDjNJvlR4RLjGORId618Q
`types`	string	Https	establishment
`guid`	string	Https	a1234qdsew3r534tgfd

Response Result Example

{
   "status":"OK",
   "predictions":[
      {
         "description":"Golden Hill, Cape Town, South Africa",
         "placeid":"ChIJF4z7mJm1zR0R0ziu67uq7Dw",
         "types":[
            "sublocality_level_2",
            "sublocality",
            "political",
            "geocode"
         ],
         "guid":"a1234qdsew3r534tgfd"
      },
      {
         "description":"Golden Hills Estate, Smuts Drive, Halfway Gardens, Midrand, South Africa",
         "placeid":"ChIJQarDjNJvlR4RLjGORId618Q",
         "types":[
            "point_of_interest",
            "establishment"
         ],
         "guid":"a1234qdsew3r534tgfd"
      },
      {
         "description":"Golden Hills Garden, Matshekgeng, Makwane, Phuthaditjhaba, South Africa",
         "placeid":"ChIJUaJO9Eyx8h4RSgT_VRF03uU",
         "types":[
            "park",
            "point_of_interest",
            "establishment"
         ],
         "guid":"a1234qdsew3r534tgfd"
      },
      {
         "description":"Golden Hill Road, Northpine, Cape Town, South Africa",
         "placeid":"EjRHb2xkZW4gSGlsbCBSb2FkLCBOb3J0aHBpbmUsIENhcGUgVG93biwgU291dGggQWZyaWNhIi4qLAoUChIJO4UKj99TzB0RDSP6OK4FtrYSFAoSCSN0noNfUcwdEUXGfH2s3Yny",
         "types":[
            "route",
            "geocode"
         ],
         "guid":"a1234qdsew3r534tgfd"
      },
      {
         "description":"Golden Hill Guest House & Tours, Wilfried & Melanie Franke, Upper Mountain Road, Golden Hill, Cape Town, South Africa",
         "placeid":"ChIJaQQoZ5q1zR0ReGR7zNKOmxs",
         "types":[
            "lodging",
            "point_of_interest",
            "establishment"
         ],
         "guid":"a1234qdsew3r534tgfd"
      }
   ]
}

2. Find Places

Find places earch return [Returns the details about the place]

{url} = https://gisapi.elections.org.za

{url}/IECGIS_VSFinder/api/places?
- {parameters} = placeid=aasdcw12e3wf&guid=a1234qdsew3r534tgfd

Calling Parameters (Input)

Parameter	Mode	Description	example values
`placeid`	string	id of place	aasdcw12e3wf
`guid`	string	unique id	a1234qdsew3r534tgfd

Interface Address

https://gisapi.elections.org.za/IECGIS_VSFinder/api/places?

Request Method

HTTP
POST

Response Parameters (Output)

Parameter	Mode	Description	example values
`status`	string	Https	OK
`StreetNr`	string	Https	0E
`StreetName`	string	Https	Smuts Drive
`Suburb`	string	Https	Halfway Gardens
`Town`	string	Https	Midrand
`Formatted_Address`	string	Https	0E Smuts Dr, Halfway Gardens, Midrand, 1686, South Africa
`Place_Address`	string	Https	Golden Hills Estate
`Types`	string	Https	point_of_interest
`LocationType`	string	Https	null
`Latitude`	string	Https	-25.9962329
`Longitude`	string	Https	28.1131973
`ProvinceID`	string	Https	3
`Province`	string	Https	Gauteng
`MunicipalityID`	string	Https	3003
`MunicipalityCode`	string	Https	JHB
`Municipality`	string	Https	JHB - City of Johannesburg
`Ward`	string	Https	79800132
`VDNumber`	string	Https	32910050
`Viewport`	string	Https	Viewport{}
`northeast`	string	Https	northeast{}
`northeast.lat`	float	Https	-25.9949273697085
`northeast.lng`	float	Https	28.1144585302915
`southwest`	string	Https	southwest{}
`southwest.lat`	float	Https	-25.99762533029151
`southwest.lng`	float	Https	28.1117605697085

Response Result Example

{
   "Status":"OK",
   "StreetNr":"0E",
   "StreetName":"Smuts Drive",
   "Suburb":"Halfway Gardens",
   "Town":"Midrand",
   "Formatted_Address":"0E Smuts Dr, Halfway Gardens, Midrand, 1686, South Africa",
   "Place_Address":"Golden Hills Estate",
   "Types":"point_of_interest",
   "LocationType":null,
   "Latitude":"-25.9962329",
   "Longitude":"28.1131973",
   "ProvinceID":"3",
   "Province":"Gauteng",
   "MunicipalityID":"3003",
   "MunicipalityCode":"JHB",
   "Municipality":"JHB - City of Johannesburg",
   "Ward":"79800132",
   "VDNumber":"32910050",
   "Viewport":{
      "northeast":{
         "lat":-25.9949273697085,
         "lng":28.1144585302915
      },
      "southwest":{
         "lat":-25.99762533029151,
         "lng":28.1117605697085
      }
   }
}