African Location API

African location data, from countries to postal-code detail.

This suite is designed to become the default geographic context layer for products that touch Africa. It already covers 54 countries, deep Nigeria state and LGA structure, full Ghana district coverage, Kenya counties, South Africa provinces, and Nigeria postcode detail.

54
Countries
774
Nigeria LGAs
260
Ghana districts
37
Nigeria states/FCT
Why this suite matters

Country, state, region, county, province, district, and LGA structure in one suite.

Nigeria postcode coverage by state and LGA with locality-level detail available on demand.

Normalized location fields such as country_code and admin_level_1/admin_level_2 names help agents use one schema across countries.

A broad African framing with strong Nigeria, Ghana, Kenya, and South Africa entry points for search.

Keyword direction

Use 'African Location API' as the primary page phrase.

Mention 'Nigeria states and LGAs API', 'Ghana districts API', 'Kenya counties API', and 'Nigeria postal code API' inside the copy.

That keeps the page broad while still capturing the country-specific long-tail terms.

Endpoints

Live endpoints in the Location suite.

View OpenAPI
GET/api/v1/location/countries
Bearer auth

Return African countries with optional region filter.

Query params
region - Filter countries by region text match.
GET/api/v1/location/countries/{country_code}
Bearer auth

Return a single country profile by ISO2 or ISO3 code.

GET/api/v1/location/countries/{country_code}/states
Bearer auth

Return states, regions, counties, or provinces for supported countries with normalized admin_level_1 fields.

GET/api/v1/location/countries/{country_code}/states/{state_code}/lgas
Bearer auth

Return LGAs, districts, or sub-county units with normalized admin_level_2 fields.

GET/api/v1/location/countries/{country_code}/states/{state_code}/postal-codes
Bearer auth

Return Nigeria postal-code coverage for a state, with optional detailed LGA lookup.

Query params
lga - Optional LGA name or code for a detailed locality-level postcode response.
limit - Rows per page when lga is provided, capped at 250.
offset - Pagination offset when lga is provided.
GET/api/v1/location/countries/{country_code}/holidays/{year}
Bearer auth

Return public holidays for a country and year.

Normalized schema

One admin model, even when countries use different labels.

Nigeria calls them states and LGAs. Ghana uses regions and districts. Kenya uses counties. South Africa uses provinces and district municipalities. Mansa API now exposes normalized admin fields in the payload so agents can reuse one parser across countries.

{
  "name": "Lagos",
  "code": "LA",
  "country_code": "NG",
  "country_name": "Nigeria",
  "entity_type": "admin_level_1",
  "admin_level": 1,
  "admin_level_1_code": "LA",
  "admin_level_1_name": "Lagos",
  "admin_level_1_type": "state"
}
Related pages