# Postcode

> APIs for Nigeria's national postcode system — search, lookup and assembly.

## Docs

- [Assemble segments into a canonical postcode](https://docs.postcode.gov.ng/api-reference/assemble-segments-into-a-canonical-postcode.md)
- [Disassemble a postcode into segments](https://docs.postcode.gov.ng/api-reference/disassemble-a-postcode-into-segments.md)
- [Graded postcode lookup (levels 1–5, cumulative)](https://docs.postcode.gov.ng/api-reference/graded-postcode-lookup-levels-1–5-cumulative.md)
- [Location search — units within a radius (default 300m)](https://docs.postcode.gov.ng/api-reference/location-search-—-units-within-a-radius-default-300m.md)
- [Segment-aware autocomplete](https://docs.postcode.gov.ng/api-reference/segment-aware-autocomplete.md)
- [Authentication](https://docs.postcode.gov.ng/authentication.md): API keys, scopes, access levels and rate limits.
- [Lookup levels](https://docs.postcode.gov.ng/concepts/lookup-levels.md): What each access level returns (L1–L5).
- [Postcode format](https://docs.postcode.gov.ng/concepts/postcode-format.md): How the 5 segments map to administrative areas.
- [Postcode API](https://docs.postcode.gov.ng/index.md): Integrate Nigeria's national postcode system — search, lookup and assembly.
- [Quickstart](https://docs.postcode.gov.ng/quickstart.md): From zero to your first postcode lookup.

## OpenAPI Specs

- [openapi](https://docs.postcode.gov.ng/api-reference/openapi.yaml)