Polling Units

GET https://naija-places.toneflix.com.ng/api/v1/states/{siso}/lgas/{liso}/wards/{ward_id}/units

Security

This endpoint uses the API KEY as a bearer token for authentication.

X-Api-Key: API_KEY
In: header

Request Parameters

Code	In	Description	Required	Type
{siso}	URL	ISO2 Code of State	YES	String
{liso}	URL	ISO2 Code of the LGA	YES	String
{ward_id}	URL	Numeric ID or slug of the ward	YES	String

Response Types

Code	Description
200	Returns a list of all Polling units in the selected Ward of the selected Local Government Area for the given state
401	Unauthorized.
404	Not Found.
429	Rate limit exeeded

Example Usage

javascript

const headers = new Headers();
const options = {
    method: "GET",
    headers: headers,
    redirect: "follow",
};

headers.append("X-Api-Key", "API_KEY");

fetch(
    "https://naija-places.toneflix.com.ng/v1/states/ab/lgas/mba/wards/1/units",
    options
)
    .then((response) => response.json())
    .then((result) => console.log(result))
    .catch((error) => console.log("error", error));

php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://naija-places.toneflix.com.ng/v1/states/ab/lgas/mba/wards/1/units',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => array(
    'X-Api-Key: API_KEY'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

axios

import axios from "axios";

axios
    .get(
        "https://naija-places.toneflix.com.ng/v1/states/ab/lgas/mba/wards/1/units",
        {
            headers: {
                X-Api-Key: "API_KEY",
            },
        }
    )
    .then(({ data }) => {
        console.log(data);
    })
    .catch((error) => {
        console.log(error);
    });

dart

var headers = {
  'X-Api-Key': 'API_KEY'
};

var request = http.Request('GET', Uri.parse('https://naija-places.toneflix.com.ng/v1/states/ab/lgas/mba/wards/1/units'));

request.headers.addAll(headers);

http.StreamedResponse response = await request.send();

if (response.statusCode == 200) {
  print(await response.stream.bytesToString());
} else {
  print(response.reasonPhrase);
}

200 Success Response

{
    "data": [
        {
            "id": 37951,
            "slug": "new-haven-primary-school-i",
            "name": "New Haven Primary School I",
            "lga": "Enugu North",
            "lgaId": 254,
            "ward": "New Haven",
            "wardId": 2908,
            "state": "Enugu",
            "stateId": 14
        },
        {
            "id": 37952,
            "slug": "new-haven-primary-school-ii",
            "name": "New Haven Primary School Ii",
            "lga": "Enugu North",
            "lgaId": 254,
            "ward": "New Haven",
            "wardId": 2908,
            "state": "Enugu",
            "stateId": 14
        },
        {
            "id": 37953,
            "slug": "new-haven-primary-school-iii",
            "name": "New Haven Primary School Iii",
            "lga": "Enugu North",
            "lgaId": 254,
            "ward": "New Haven",
            "wardId": 2908,
            "state": "Enugu",
            "stateId": 14
        },
        ...
    ],
    "status": "success",
    "message": "Data Fetched.",
    "statusCode": 200
}

401 Error Response

{
    "data": {},
    "statusCode": 401,
    "message": "Unauthorized. You do not have access to this resource.",
    "status": "error"
}

429 Error Response

{
    "data": {},
    "statusCode": 429,
    "message": "Rate limit exeeded: you may try again in 54 seconds.",
    "status": "error"
}

404 Error Response

{
    "data": {},
    "statusCode": 404,
    "message": "State not found.",
    "status": "error"
}

{
    "data": {},
    "statusCode": 404,
    "message": "Local government area not found.",
    "status": "error"
}

{
    "data": {},
    "statusCode": 404,
    "message": "Ward not found.",
    "status": "error"
}