{"info":{"_postman_id":"b631c71f-f999-4ac0-a6ad-9819efa90d9c","name":"Kenya Electoral Wards API","description":"

Introduction

\n

The Kenya Electoral Wards API provides the user with the names of all the wards in a particular county or counties based on the URL parameters provides. With this payload, the user can choose the data they want to consume in their app/website.

\n

Kenya has 47 counties. Each county is divided into constituencies and each constituency is divided into wards. As such, wards are the smallest electoral divisions in the country and closest the citizens can get government services.

\n

The code for this API can be found at https://github.com/bwainaina380/kenya-wards-constituencies-county-rest-api

\n

For any questions, please feel free to contact me at:\nEmail: bwainaina380@gmail.com\nTwitter: @bwainaina380

\n

Overview

\n

The most important thing you need to know as a developer is the syntax I've used when adding the names of the counties to the database. If you do not write the names exactly as in the following list, you will get an empty response.

\n

Make sure you follow the capitalizations and dashes that I've used to the letter.

\n

VERY IMPORTANT: There are counties with 2 names. Examples are \"West Pokot\", \"Homa Bay\" and \"Uasin Gishu\". When performing a GET request on such counties, you need to separate the two names with a \"+\".

\n

Example: \n/api/wards?county=West+Pokot\n/api/wards?county=Homa+Bay\n/api/wards?county=Uasin+Gishu

\n
    \n
  1. Mombasa
    2. \n
  2. Kwale
    3. \n
  3. Kilifi
    4. \n
  4. Tana-River
    5. \n
  5. Lamu
    6. \n
  6. Taita-Taveta
    7. \n
  7. Garissa
    8. \n
  8. Wajir
    9. \n
  9. Mandera
    10. \n
  10. Marsabit
    11. \n
  11. Isiolo
    12. \n
  12. Meru
    13. \n
  13. Tharaka-Nithi
    14. \n
  14. Embu
    15. \n
  15. Kitui
    16. \n
  16. Machakos
    17. \n
  17. Makueni
    18. \n
  18. Nyandarua
    19. \n
  19. Nyeri
    20. \n
  20. Kirinyaga
    21. \n
  21. Muranga
    22. \n
  22. Kiambu
    23. \n
  23. Turkana
    24. \n
  24. West Pokot
    25. \n
  25. Samburu
    26. \n
  26. Trans-Nzoia
    27. \n
  27. Uasin Gishu
    28. \n
  28. Elgeyo-Marakwet
    29. \n
  29. Nandi
    30. \n
  30. Baringo
    31. \n
  31. Laikipia
    32. \n
  32. Nakuru
    33. \n
  33. Narok
    34. \n
  34. Kajiado
    35. \n
  35. Kericho
    36. \n
  36. Bomet
    37. \n
  37. Kakamega
    38. \n
  38. Vihiga
    39. \n
  39. Bungoma
    40. \n
  40. Busia
    41. \n
  41. Siaya
    42. \n
  42. Kisumu
    43. \n
  43. Homa Bay
    44. \n
  44. Migori
    45. \n
  45. Kisii
    46. \n
  46. Nyamira
    47. \n
  47. Nairobi
    48. \n
\n

Authentication

\n

There is no authentication required to use this API. I will keep an eye on the number of requests to the API, and if it hits 10000 requests per month, I will enable authorization.

\n

This will help me know who is using the API and for what purpose.

\n

Error Codes

\n

402 - You will get this error when you try to perform a POST request without providing one or all of the following in the request body:

\n
    \n
  1. Ward name
    2. \n
  2. Constituency name
    3. \n
  3. County Name
    4. \n
\n

In all other cases, you will get an empty response, showing that you have entered a county that does not exist in Kenya, or you have a typo in the request parameter.

\n

Rate limit

\n

As of this writing, I have not imposed any rate limit on the use of this API.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introduction","slug":"introduction"},{"content":"Overview","slug":"overview"},{"content":"Authentication","slug":"authentication"},{"content":"Error Codes","slug":"error-codes"},{"content":"Rate limit","slug":"rate-limit"}],"owner":"4315414","collectionId":"b631c71f-f999-4ac0-a6ad-9819efa90d9c","publishedId":"Rzn8NgRo","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2018-12-21T10:05:15.000Z"},"item":[{"name":"https://frozen-basin-45055.herokuapp.com/api/wards?county=Nairobi","id":"ad7c7080-769d-4277-8f29-10eecb75c8f6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":"https://frozen-basin-45055.herokuapp.com/api/wards?county=Nairobi","description":"

This returns the names of all the wards in \"Nairobi\" county. You can replace \"countyName\" with the name of any of the 47 counties in the country.

\n","urlObject":{"protocol":"https","path":["api","wards"],"host":["frozen-basin-45055","herokuapp","com"],"query":[{"key":"county","value":"Nairobi"}],"variable":[]}},"response":[{"id":"25cf2bb5-76b4-4da4-8649-effda727b017","name":"Default","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":{"raw":"https://frozen-basin-45055.herokuapp.com/api/wards?county=Nairobi","protocol":"https","host":["frozen-basin-45055","herokuapp","com"],"path":["api","wards"],"query":[{"key":"county","value":"Nairobi"}]}},"code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n\"_id\": \"5c1b84588a6e0a0004a71cab\",\n\"name\": \"Kitisuru\",\n\"constituency\": \"Westlands\",\n\"county\": \"Nairobi\",\n\"__v\": 0\n},\n{\n\"_id\": \"5c1b84778a6e0a0004a71cac\",\n\"name\": \"Parklands\",\n\"constituency\": \"Westlands\",\n\"county\": \"Nairobi\",\n\"__v\": 0\n}"}],"_postman_id":"ad7c7080-769d-4277-8f29-10eecb75c8f6"},{"name":"https://frozen-basin-45055.herokuapp.com/api/wards?county=Nairobi&county=Mombasa","id":"3005d672-9967-4fd1-920b-29332a97172e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":"https://frozen-basin-45055.herokuapp.com/api/wards?county=Nairobi&county=Mombasa","description":"

This returns the names of all the wards in Nairobi and Mombasa counties. You can replace \"Nairobi\" or \"Mombasa\" with the name of any of the 47 counties in the country. You can display more counties. Just separate them with \"&\" as shown in this request URL example.

\n","urlObject":{"protocol":"https","path":["api","wards"],"host":["frozen-basin-45055","herokuapp","com"],"query":[{"key":"county","value":"Nairobi"},{"key":"county","value":"Mombasa"}],"variable":[]}},"response":[{"id":"ba225d28-da0c-4db0-80b0-25374dde1748","name":"Default","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":{"raw":"https://frozen-basin-45055.herokuapp.com/api/wards?county=Nairobi&county=Mombasa","protocol":"https","host":["frozen-basin-45055","herokuapp","com"],"path":["api","wards"],"query":[{"key":"county","value":"Nairobi"},{"key":"county","value":"Mombasa"}]}},"code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n\"_id\": \"5c1b82048a6e0a0004a71c88\",\n\"name\": \"Nyaura\",\n\"constituency\": \"Nyaribari Chache\",\n\"county\": \"Kisii\",\n\"__v\": 0\n},\n{\n\"_id\": \"5c1b84588a6e0a0004a71cab\",\n\"name\": \"Kitisuru\",\n\"constituency\": \"Westlands\",\n\"county\": \"Nairobi\",\n\"__v\": 0\n}"}],"_postman_id":"3005d672-9967-4fd1-920b-29332a97172e"},{"name":"https://frozen-basin-45055.herokuapp.com/api/wards","id":"3e2b3982-3ae4-4a35-b496-13cbc950a934","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \"name\":\"Kilimambogo\", \"constituency\":\"Kilima\", \"county\":\"Kakamega\"}"},"url":"https://frozen-basin-45055.herokuapp.com/api/wards","description":"

This adds a new ward to the wards database. You need to provide the name of the ward on the \"name\" property, the name of the constituency on the \"constituency\" property and the name of the county on the \"county\" property.

\n","urlObject":{"protocol":"https","path":["api","wards"],"host":["frozen-basin-45055","herokuapp","com"],"query":[],"variable":[]}},"response":[{"id":"11291ae4-9a0f-4d65-a3d5-b96c3abe7937","name":"Default","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \"name\":\"Kilimambogo\", \"constituency\":\"Kilima\", \"county\":\"Kakamega\"}"},"url":"https://frozen-basin-45055.herokuapp.com/api/wards"},"code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n\"_id\": \"5c1b84588a6e0a9874a71cab\",\n\"name\": \"Kilimambogo\",\n\"constituency\": \"Kilima\",\n\"county\": \"Kakamega\",\n\"__v\": 0\n}"}],"_postman_id":"3e2b3982-3ae4-4a35-b496-13cbc950a934"},{"name":"https://frozen-basin-45055.herokuapp.com/api/wards/:id","id":"794c7b50-225b-44cf-b6bb-5b628bcf3043","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{ \"name\":\"Kilimambogo\", \"constituency\":\"Kitui East\", \"county\":\"Kitui\"}"},"url":"https://frozen-basin-45055.herokuapp.com/api/wards/:id","description":"

This updates data about the ward whose id is specified in the \"id\" request parameter.

\n","urlObject":{"protocol":"https","path":["api","wards",":id"],"host":["frozen-basin-45055","herokuapp","com"],"query":[],"variable":[{"type":"any","key":"id"}]}},"response":[{"id":"756b007a-47d2-45af-9a57-dbc53801fa63","name":"Default","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{ \"name\":\"Kilimambogo\", \"constituency\":\"Kitui East\", \"county\":\"Kitui\"}"},"url":{"raw":"https://frozen-basin-45055.herokuapp.com/api/wards/:id","protocol":"https","host":["frozen-basin-45055","herokuapp","com"],"path":["api","wards",":id"],"variable":[{"key":"id"}]}},"code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n\"_id\": \"5c1b84588a6e0a9874a71cab\",\n\"name\": \"Kilimambogo\",\n\"constituency\": \"Kitui East\",\n\"county\": \"Kitui\",\n\"__v\": 0\n}"}],"_postman_id":"794c7b50-225b-44cf-b6bb-5b628bcf3043"},{"name":"https://frozen-basin-45055.herokuapp.com/api/wards/:id","id":"de0e78af-0efd-42b6-be5e-9da1d91fb703","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":""},"url":"https://frozen-basin-45055.herokuapp.com/api/wards/:id","description":"

This deletes the ward whose id is specified in the \"id\" request parameter.

\n","urlObject":{"protocol":"https","path":["api","wards",":id"],"host":["frozen-basin-45055","herokuapp","com"],"query":[],"variable":[{"type":"any","key":"id"}]}},"response":[{"id":"9d775558-db7f-40e8-8c74-4973a447144c","name":"Default","originalRequest":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":""},"url":{"raw":"https://frozen-basin-45055.herokuapp.com/api/wards/:id","protocol":"https","host":["frozen-basin-45055","herokuapp","com"],"path":["api","wards",":id"],"variable":[{"key":"id"}]}},"code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n\"_id\": \"5c1b84588a6e0a9874a71cab\",\n\"name\": \"Kilimambogo\",\n\"constituency\": \"Kitui East\",\n\"county\": \"Kitui\",\n\"__v\": 0\n}"}],"_postman_id":"de0e78af-0efd-42b6-be5e-9da1d91fb703"}]}