Skip to main content

​
1. Get an API key

Create an account in the developer dashboard, then go to Settings → API Keys → Create key. Copy the secret — it’s shown once.
Search and Lookup L1 work without a key. You only need a key for Lookup L2+.

​
2. Make a request

Pass your key in the X-API-Key header. 
curl "https://api.postcode.gov.ng/v1/lookup?code=EK-01-A03-FK-01&level=1"

​
3. Response

{
  "data": {
    "postcode": "EK-01-A03-FK-01",
    "valid": true,
    "administrative_address": {
      "state_name": "EKITI",
      "lga_name": "ADO EKITI",
      "locality_name": "ADO EKITI",
      "zone": "SOUTH WEST"
    },
    "recent_house_address": { "recent": "NTA ROAD, BACK OF FABIAN HOTEL, ADO EKITI" },
    "building_use_status": "residential"
  }
}
The attributes returned depend on the level you request and your granted access level — see Lookup levels.

​
Try autocomplete

Type-ahead suggestions are public (no key): 
curl "https://api.postcode.gov.ng/v1/search/autocomplete?q=EK01"