Nigeria Electoral Open API

REST API · v1.0.0 · Free & Open Access

Open Swagger UI OpenAPI JSON

↑ Endpoints

🔌

API Endpoints

↑ Resources

📦

Resource Types

Format

📄

JSON

Response Format

↑ Free

🔓

Open

No Auth Required

Base URL

All API requests are prefixed with this base URL


                                https://crediblevoteng.com/api/v1

Available Endpoints

All endpoints return JSON · No authentication required

9 endpoints

Method	Endpoint	Description	Tag
GET	`/api/v1/summary`	Overall counts — states, LGAs, wards, polling units	Summary
GET	`/api/v1/states`	List all states with pagination & active filter	States
GET	`/api/v1/states/{id}`	Get a single state by UUID	States
GET	`/api/v1/states/{stateId}/lgas`	List all LGAs within a state	LGAs
GET	`/api/v1/states/{stateId}/lgas/{lgaId}`	Get a single LGA by UUID	LGAs
GET	`/api/v1/states/{stateId}/lgas/{lgaId}/wards`	List all wards within an LGA	Wards
GET	`/api/v1/states/{stateId}/lgas/{lgaId}/wards/{wardId}`	Get a single ward with all its polling units	Wards
GET	`/api/v1/states/{stateId}/lgas/{lgaId}/wards/{wardId}/polling-units`	List all polling units within a ward	Polling Units

All endpoints support pagination via ?page=1&limit=50

Response Format

All responses follow a consistent envelope structure

{
  "status": "success",
  "data": { ... },
  "timestamp": "2024-01-01T00:00:00+00:00"
}

Error responses use the same envelope:

{
  "status": "error",
  "message": "State not found",
  "timestamp": "2024-01-01T00:00:00+00:00"
}

Pagination

List endpoints support page-based pagination

GET /api/v1/states?page=2&limit=10

{
  "status": "success",
  "data": {
    "states": [ ... ],
    "total": 37,
    "page":  2,
    "limit": 10,
    "pages": 4
  },
  "timestamp": "..."
}

Default limit 50

Maximum limit 100

First page page=1

Explore & Test the API Interactively

Use the Swagger UI to browse every endpoint, see request/response schemas, and fire live requests directly from your browser.

Open Swagger UI