Nigeria Opens Postcode API, But It's Not Free to Build On
Days after Nigeria launched its National Digital Alphanumeric Postcode System on October 1, Minister Bosun Tijani opened the developer layer, publishing API documentation at docs.postcode.gov.ng and inviting organisations to register, integrate, and build products on the country’s new 11-character building-level addressing system. NIPOST built the system with geospatial partner Milsat, covering over 90% of addressable buildings at launch, with full national coverage targeted by year-end.

The Six-Step Onboarding Process

  • Create an organisation account
  • Submit Know Your Business (KYB) documentation
  • Request API access, specifying the access level needed
  • Receive staging tokens for development and testing
  • Complete User Acceptance Testing with NIPOST’s technical and compliance teams
  • Receive production tokens and go live

The KYB requirement at step two is notable on its own: this is not an open, anonymous API key signup like most consumer-facing developer platforms. Every organisation integrating the postcode system identifies itself to NIPOST before writing a line of production code.

The Free Tier Is Narrower Than the Pitch Suggests

NIPOST’s own access structure splits the API into five tiers, and only Level 1, basic lookup that confirms whether a postcode is valid and returns its Local Government Area, is actually free and keyless. Anything beyond that, the kind of integration a logistics app, fintech KYC flow, or e-commerce checkout would actually need, requires a KYB-verified account and a requested access level, which is where the real gatekeeping sits. “Go on and build” is accurate for hobbyists checking a single address; it understates what a startup needs to clear before shipping a product that depends on the postcode layer.

What This Means for the Data Question Already Raised

The KYB requirement for every integrating organisation adds a layer worth watching alongside the census-data reuse and tiered-access questions already raised about this system: NIPOST does not just control who can query a building’s postcode, it now holds a registry of every business, fintech, and logistics platform choosing to build location features on government rails, and what access level each requested. That is useful for oversight and abuse prevention, the same justification NIPOST gave for tiered data access generally, but it also means the developer ecosystem itself becomes another layer of traceable, centrally-logged activity sitting on top of the underlying building-to-census data link.

What Happens Next

For developers, the practical path is straightforward: individual lookups are free today at postcode.gov.ng, but anyone building a product on top of the system should budget time for the KYB and UAT stages before assuming they can ship. Nigeria’s own estimate, that poor addressing costs the economy ₦50-80 billion annually in failed deliveries, is the commercial case driving this rollout, and it is real. Whether the API’s access tiers end up priced and gated in a way that lets small Nigerian developers actually compete with larger logistics and fintech incumbents, or whether KYB and paid tiers end up favouring only well-capitalised players, is the detail that will determine if this becomes the open infrastructure layer Tijani is pitching, or another system only big players can afford to integrate with.

Follow us on Bluesky, LinkedIn, X, and Telegram to Get Instant Updates