> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postcode.gov.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Lookup levels

> What each access level returns (L1–L5).

Lookup responses are **graded into 5 cumulative levels** — each higher level adds attributes on
top of the ones below it. Request a level with the `level` query param; the response is capped at
your organization's granted level.

| Attribute                    |  L1 |  L2 |  L3 |  L4 |  L5 |
| ---------------------------- | :-: | :-: | :-: | :-: | :-: |
| Validity status              |  ✓  |  ✓  |  ✓  |  ✓  |  ✓  |
| Administrative address       |     |  ✓  |  ✓  |  ✓  |  ✓  |
| Recent house address         |     |  ✓  |  ✓  |  ✓  |  ✓  |
| Building use status          |     |     |  ✓  |  ✓  |  ✓  |
| Other building info          |     |     |     |  ✓  |  ✓  |
| Point geometry (coordinates) |     |     |     |     |  ✓  |

<Note>
  **L1** is free. **L2–L4** are commercial (consume credits). **L5** (exact coordinates) is
  restricted and granted on review.
</Note>

## Example

```bash theme={null}
# L1 — validity only
curl "https://api.postcode.gov.ng/v1/lookup?code=EK-01-A03-FK-01&level=1"

# L5 — everything, incl. coordinates (requires granted L5 key)
curl "https://api.postcode.gov.ng/v1/lookup?code=EK-01-A03-FK-01&level=5" \
  -H "X-API-Key: nipost_live_xxx"
```

```json L5 response theme={null}
{
  "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",
    "other_building_info": { "type": "Bungalow", "owner": "Private Ownership", "delivery_point": true },
    "point_geometry": { "type": "Point", "coordinates": [5.186046, 7.623567] }
  }
}
```

Need a higher level? Request it under **Settings → KYB & Access** in the dashboard.