# /postcode — Open Data Proxy

Use GET /postcode?code=…&number=… to expand a Dutch postcode into street, city, municipality, province and coordinates.

## Purpose

Use GET /postcode?code=…&number=… to expand a Dutch postcode into street, city, municipality, province and coordinates.

Price: $0.01 USDC

## Request

```
GET /postcode?code=1012AB&number=1
```

## Input

- `code` — example: `1012AB`
- `number` — example: `1`

## Response

```json
{
  "input": "1012AB",
  "houseNumber": "1",
  "street": "Stadhouderskade",
  "city": "Amsterdam",
  "municipality": "Amsterdam",
  "province": "Noord-Holland",
  "lat_lon": "52.3633,4.8823",
  "valid": true
}
```

## Payment

No API key. Call once to receive `402 Payment Required` with the x402
terms, pay $0.01 USDC on Base Mainnet via https://x402.thesoulnetwork.eu, then send the 1-hour ticket as
`Authorization: Bearer <ticket>`.