Ziemozi Election Monitoring Result API

This is a very simple API to allow anyone to download crowd sourced election results and incident
reports. The crowd sourced information will come form the Ziemozi app which will be free to
download from the end of January.

The API allows for downloading of all or subsections of the data using simple calls of the format

https://<ServiceUrl>?query_string.

ServiceUrl are

https://www-ziemfms-7ced.restdb.io/election-result for election result OR

https://www-ziemfms-7ced.restdb.io/election-incident for election incidents.

NOTE : These URLs are test environment URLs hosted on restdb.io and are rate limited. It is
preferable to download all available data at once and do analysis on your own client as
multiple calls may fail.

query_string are name value pairs for different fields. As an example

https://www-ziemfms-7ced.restdb.io/election-result?state=Enugu queries the election

results for Enugu State and gets this response

{ "request" : {
"state": "Enugu"
},

"result" :
[

{
"_id":"5c3ca13b4b4fa15f00005ebc",
"votes": 500,
"confidence": 0.4543417396489531,
"booth": "HILTOP",
"election": "PRESIDENTIAL_2019",
"picture": "https://media.premiumtimesng.com/wp-content/files/2015/03/Kano-PUs-Results.jpg",
"reportedBy": “Letha.Gusikowski@Larkin.ca,08090878901",
"reportedFrom": “7,6,7.65”,
"party": "PDP",
"ward": "UNADU1002",
"state": "Enugu",
"lga": "IgboEze South",
"constituency": "Nsukka/IgboEze Federal "
"_version":"6",
"_created": "2019-01-14T14:48:27.320Z",
"_createdby": "mockdata generator",
"_mock": "true",
"_changed": "Mon Jan 14 2019 18:51:44 GMT+0100 (CET)",
"_changedby": "james.agada@cwlgroup.com"
},

{}
]
}

The response is a JSON document with two major objects - the request object shows the original
request while the result object has an array of result elements showing the results as reported. The
following tables show the fields for results and for incidents.

"_id":"5c3ca13b4b4fa15f00005ebc", Record id

"votes": 500, number of votes

"confidence": 0.4543417396489531, confidence level. this may or my not be

meaningful.

"booth": "HILTOP", the booth from which result is reported

"election": "PRESIDENTIAL_2019", the type of election

"picture": "https://media.premiumtimesng.com/wp- Comma separated URLs showing the

content/files/2015/03/Kano-PUs-Results.jpg", pictures associated with the record.
Typically this should be the pictures of the
result sheets. These are not validated.

"reportedBy": “Letha.Gusikowski@Larkin.ca, The details of the person making this

08090878901", report

"reportedFrom": “7,6,7.65”, location from where the report is made in

latitude and longitude

"party": "PDP", The party that has the reported votes

"ward": "UNADU1002", The ward where the booth is located.

"state": "Enugu", The State where the booth is located

"lga": "IgboEze South", the LG where the booth is located

"constituency": "Nsukka/IgboEze Federal " The constituency from which the report
arises

"_version":"6", System record

"_created": "2019-01-14T14:48:27.320Z", System record

"_createdby": "mockdata generator", System record

"_mock": "true", System record

"_changed": "Mon Jan 14 2019 18:51:44 GMT+0100 System record

(CET)",

"_changedby": "james.agada@cwlgroup.com" System record

NOTE: There could be multiple records for the same booth for same election from different people
or even the same person. Some records may also have incomplete details for instance no picture
or empty fields. You have to apply your own logic to get unique and acceptable result. For
instance a simple check will reject all records without an accompanying picture OR records
reported by only one person. If anyone can get the GPS location of polling booths, further
analysis of the image can retrieve the location where the picture was taken from and compare it
with the location where the report was sent from. Election results may also show records for
things like REGISTEREDVOTERS, ACCREDITEDVOTERS, VOTESCAST, VOIDVOTES under
parties.

"_id": "5c3d70f34b4fa15f000069d4" Record id

"lga": “Ibadan East” LG where incident happened

"ward": “Molette" Ward where incident happened

"state": “Oyo" State where incident happened

"election": “PRESIDENTIAL_2019”

"reportedFrom": "42.3271"

"reportedBy": "Jimmy.Stoltenberg@yahoo.com"

"reportedAt": "1985-12-15T23:00:00.000Z"

"picture": "http://www.Stracke.biz/"

"report": "Nam ut enim ea fugiat ea. Rerum iure

consequatur possimus ut porro. Sint ea ut vel
beatae autem."

"incident_type": “BALLOT SNATCHED”

"booth": “Motor Park”

"incident_date": "2012-05-24T22:00:00.000Z"

"incident_value": "sapiente"

"_version": 1

"_created": "2019-01-15T05:34:43.598Z"

"_createdby": "mockdata generator"

"_mock": true