States & LGAs

GET/api/v1/general/states

Two utility lookups for Nigerian geography: fetch all 36 states (plus the FCT), then fetch the Local Government Areas within any one of them. Use them to populate address forms, validate user input, and drive location-based logic.

Headers

Header	Required	Description
`Authorization`	Yes	Your app’s secret key, sent as-is — not `Bearer`.
`AppId`	Yes	The App ID from your dashboard.

List of states

Call GET /api/v1/general/states with no query parameters. Returns a states array of every Nigerian state name (including the Federal Capital Territory).

200 — OK

{
  "states": [
    "Abia", "Adamawa", "Akwa Ibom", "Anambra",
    "Bauchi", "Bayelsa", "Benue", "Borno",
    "Cross River", "Delta", "Ebonyi", "Edo",
    "Ekiti", "Enugu", "Federal Capital Territory",
    "Gombe", "Imo", "Jigawa", "Kaduna",
    "Kano", "Katsina", "Kebbi", "Kogi",
    "Kwara", "Lagos", "Nasarawa", "Niger",
    "Ogun", "Ondo", "Osun", "Oyo",
    "Plateau", "Rivers", "Sokoto", "Taraba",
    "Yobe", "Zamfara"
  ]
}

List of LGAs

Call GET /api/v1/general/states/lgas with a state query parameter (a state name from the list above). Returns an lgas array of the Local Government Areas in that state.

Parameter	Type	Required	Description
`state`	string	Yes	The state name obtained from the states endpoint, e.g. `Lagos`.

GET /api/v1/general/states/lgas

curl --request GET "https://api.dojah.io/api/v1/general/states/lgas?state=Lagos" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

200 — OK

{
  "lgas": [
    "Agege", "Ajeromi-Ifelodun", "Alimosho",
    "Amuwo-Odofin", "Apapa", "Badagry",
    "Epe", "Eti-Osa", "Ibeju-Lekki",
    "Ifako-Ijaiye", "Ikeja", "Ikorodu",
    "Kosofe", "Lagos Island", "Lagos Mainland",
    "Mushin", "Ojo", "Oshodi-Isolo",
    "Shomolu", "Surulere"
  ]
}

Errors

Code	Meaning
`400`	Bad request — for the LGA lookup, the `state` parameter is missing or not a recognised state name.
`401`	Unauthorized — check your secret key and `AppId` (no `Bearer` prefix).
`429`	Too many requests — back off and retry.

curl --request GET \
  "https://api.dojah.io/api/v1/general/states" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

// States — no params. For LGAs add ?state=Lagos
const res = await fetch("https://api.dojah.io/api/v1/general/states", {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests  # States — no params. LGAs: params={"state": "Lagos"}

res = requests.get(
    "https://api.dojah.io/api/v1/general/states",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
)
data = res.json()

{
  "states": [
    "Abia", "Adamawa", "Akwa Ibom",
    "…", "Lagos", "…", "Zamfara"
  ]
}

Get started

Core concepts

API Endpoints

Widget SDKs

API clients

Headers

List of states

List of LGAs

Errors

​Headers

​List of states

​List of LGAs

​Errors

Headers

List of states

List of LGAs

Errors