Election Night Media

Once you get a version of “01/01/9999 12:00:00 AM” then you should stop polling, as the election is over and the results aren't going to change anymore. You can then poll the version once a day to see if it's changed to “12/31/9999 12:59:59 PM” (results are official). It is not necessary to poll multiple times a minute. Polling once a minute is sufficient.

Step 1: Sign Up

Visit our Sign Up Page to register for an account.

Step 2: Approval

Once your media credentials have been reviewed, you will be emailed keys for accessing our REST API for real-time XML election results.
If you have questions about your approval status, please Contact Us.

Step 3: Make XML Requests

REST API queries take the form of https://voterportal.sos.la.gov/api/MediaRequests/XmlFileName/ElectionDate/AccessKey/SecretKey

Available XML Files:
List of Races and Candidates: RacesAndCandidates
Parish Level Results: ParishVotes
Precinct Level Results: PrecinctVotes
Version Information: LatestVersion

Election dates must be in yyyy-mm-dd format, e.g. 2017-03-25.
Only the 2017-03-25 election and beyond are available via this system.

The Version Information XML will be updated whenever results data changes; you should use it to avoid unnecessary API requests.
Accounts found to be abusing the API may be temporarily disabled.

Example:
To request the list of races and candidates for the March 25th, 2017 election...
https://voterportal.sos.la.gov/api/MediaRequests/RacesAndCandidates/2017-03-25/AccessKey/SecretKey

Additional Information