Skip to content

Cale-Torino/Registertovote_Elections_API

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 

Repository files navigation

Registertovote Elections API [2024]


Developed by C.A Torino, TECHRAD Radical Technology

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
      }
   }
}



Endpoints

https://gisapi.elections.org.za/IECGIS_VSFinder/api/autocomplete?input=GoldenHill&guid=a1234qdsew3r534tgfd

https://gisapi.elections.org.za/IECGIS_VSFinder/api/places?placeid=ChIJQarDjNJvlR4RLjGORId618Q&guid=a1234qdsew3r534tgfd

https://gisapi.elections.org.za/IECGIS_VSFinder/api/VotingDistrict?latitude=-25.9949273697085&longitude=28.1144585302915

https://gisapi.elections.org.za/IECGIS_VSFinder/api/Ward?wardid=79800132

https://gisapi.elections.org.za/IECGIS_VSFinder/api/Municipality?municid=3003

https://gisapi.elections.org.za/IECGIS_VSFinder/api/MEO?municid=3003

Gov API docs

https://gisapi.elections.org.za/iecgis_api/

Contact Centre

ERS

VMD

Voter Portal

VRS

VS Finder

Political Parties/Media