# International Address Formats

Postal address formats, postal-code validation and subdivisions for about 240 countries from a bundled Google i18n snapshot.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://address-formats.x402tookit.com/openapi.json
- x402 manifest: https://address-formats.x402tookit.com/.well-known/x402
- Catalog (free): https://address-formats.x402tookit.com/catalog
- Health (free): https://address-formats.x402tookit.com/health
- Uptime (free): https://address-formats.x402tookit.com/uptime

## Endpoints (8)

### GET /address-format — $0.02
A country's postal address layout: line order template, required fields, uppercase rules and field labels.
Params: country: string
Example: https://address-formats.x402tookit.com/address-format?country=US

### GET /address-parse-hints — $0.02
Guess which country a postal code belongs to from its shape among candidates, flagging ambiguity honestly.
Params: postal_code: string, candidates?: string
Example: https://address-formats.x402tookit.com/address-parse-hints?postal_code=94043&candidates=US%2CDE%2CFR%2CMX

### GET /country-address-fields — $0.02
Which address fields a country uses and their local labels: state/province/county, city, district, postal code.
Params: country: string
Example: https://address-formats.x402tookit.com/country-address-fields?country=IE

### GET /format-address — $0.02
Render address parts into a country's standard multi-line mailing format with its uppercase rules; reports missing fields.
Params: country: string, street: string, city?: string, state?: string, postal_code?: string, recipient?: string, organization?: string, dependent_locality?: string, sorting_code?: string, latin?: boolean
Example: https://address-formats.x402tookit.com/format-address?country=GB&recipient=Jane+Doe&street=10+Downing+Street&city=London&postal_code=SW1A+2AA

### GET /po-box-check — $0.02
Heuristic check whether an address line uses PO box wording in English, German, French, Spanish and more; not proof.
Params: text: string
Example: https://address-formats.x402tookit.com/po-box-check?text=P.O.+Box+1234

### GET /postal-code-check — $0.02
Check a postal code against a country's pattern, and a state/province's prefix pattern where the data lists one.
Params: country: string, postal_code: string, subdivision?: string
Example: https://address-formats.x402tookit.com/postal-code-check?country=US&postal_code=94043&subdivision=CA

### GET /postal-code-examples — $0.02
Sample postal codes for a country from the dataset's examples, each checked against the country's own pattern.
Params: country: string, limit?: integer
Example: https://address-formats.x402tookit.com/postal-code-examples?country=NL

### GET /subdivisions — $0.02
Administrative divisions (states, provinces) of a country with codes, names and postal prefix patterns, from the dataset.
Params: country: string, q?: string, limit?: integer
Example: https://address-formats.x402tookit.com/subdivisions?country=CA

## Terms

Computed from a bundled snapshot of Google's open i18n address data. Formats and postal-code patterns can be out of date or incomplete; a code matching a pattern does not prove it exists. Not a postal authority.