Skip to main content
A postcode is 12 characters across 5 segments, template AA-99-H77-BB-55 (displayed with spaces: AA 99 H77 BB 55).
SegmentExampleMeaningFormat
AAEKState2 alpha
9901LGA within the state2 numeric (zero-filled)
H77A03District within the LGA3 alphanumeric
BBFKArea within the district2 alpha
5501Building unit within the area2 numeric (zero-filled)
So EK-01-A03-FK-01 = building 01, in area FK, district A03, LGA 01 (Ado-Ekiti), state EK (Ekiti).

Rules

  • Numeric segments are zero-filled (101) and range 01–99 (never 00).
  • The three styles are interchangeable on input — the API is tolerant of spaces, hyphens and case: EK-01-A03-FK-01, EK 01 A03 FK 01, ek01a03fk01.

Assemble & disassemble

Use the Assembly endpoints to build or parse codes programmatically:
# Assemble (zero-fills + formats)
curl -X POST "https://api.postcode.gov.ng/v1/assembly/assemble" \
  -d '{"state":"ek","lga":"1","district":"a03","area":"fk","unit":"1"}'
# → { "data": { "postcode": "EK-01-A03-FK-01", "display": "EK 01 A03 FK 01", "compact": "EK01A03FK01" } }

# Disassemble
curl "https://api.postcode.gov.ng/v1/assembly/disassemble?code=EK01A03FK01"