Validate and enrich addresses in 120+ countries with a single API call. UK addresses are verified against Royal Mail PAF. International addresses use OpenStreetMap data. Fraud signals, delivery risk scoring, and geocode — all in one response. Powered by AI.
120+
Countries
20
Free requests
99.9%
Uptime SLA
Used in
PropTech API Solution →Live Demo — UK or any global address
CAPABILITIES
Validate addresses globally. UK addresses route to Royal Mail PAF for authoritative confirmation. All other countries use OpenStreetMap data — 120+ countries, zero configuration needed.
Detects IP country mismatch, disposable email domains, invalid phone numbers, and unconfirmed addresses — returning a structured fraud_signals array on every request.
Every /enrich response returns a delivery risk score — LOW, MEDIUM, or HIGH — aggregated from address validity, IP geolocation, and contact signal checks.
No country parameter needed. The agent detects UK postcodes automatically and routes to Royal Mail PAF. Everything else routes to global geocoding — fully transparent to the caller.
Latitude, longitude, and a HIGH / MEDIUM / LOW confidence score returned with every address — UK or global. No separate geocoding API. One call, one response.
Accepts plain English, partial addresses, and postcodes in any language. Resolves typos and ambiguous input globally — no rigid form fields or exact postcode required.
GLOBAL COVERAGE
The Address Agent automatically routes each request to the right data source. UK addresses go to Royal Mail PAF. Everything else uses OpenStreetMap data. No country parameter. Same response schema everywhere.
Plain English input — full address, partial address, postcode, or mixed language.
Agent detects UK postcode format automatically. No country parameter needed from the caller.
Exact building-level confirmation against the definitive UK postal dataset.
120+ countries via OpenStreetMap data. Attribution: © OpenStreetMap contributors.
Same JSON schema for every country — valid, confidence, canonical_address, geocode, fraud_signals.
United Kingdom
Royal Mail PAF — full building-level confirmationUnited States
Street & ZIP code level geocodingGermany
Straße, PLZ, StadtteilFrance
Rue, code postal, communeAustralia
Street address + state + postcodeIndia
Street, city, PIN codeCanada
Street address + postal codeJapan
Prefecture, city, chomeBrazil
Rua, bairro, CEPUAE
Emirate, area, streetSouth Africa
Street, suburb, postal code| Level | UK (Royal Mail PAF) | Global ( OSM) |
|---|---|---|
| HIGH | Building confirmed in PAF | result_type: building or street |
| MEDIUM | Postcode confirmed, building not listed | result_type: city or postcode |
| LOW | Address found via text search | result_type: county, state, or country |
USE CASES
The Address Agent replaces multiple point solutions with a single intelligent endpoint. Here is how different industries use it today.
Real estate analysts spend hours validating property addresses before running comparables, planning applications, or investment models. The Address Agent replaces that manual work with a single API call.
Validate property addresses before populating CRM or data warehouse
Enrich addresses with district, ward, and geocode for mapping
Pre-screen investment targets — confirm postal deliverability before due diligence
Power address autocomplete in property search platforms
Traditional APIs return raw PAF records. The Address Agent returns interpreted, contextualised data — district boundaries, geocode, confidence level — saving your development team from writing parsing logic.
AI vs. TRADITIONAL
The UK Postcode API returns raw PAF records — fast and cheap for simple lookups. The Address Agent returns enriched intelligence: fraud signals, delivery risk, address type, and geocode — in one call, without writing parsing logic.
| Capability | Traditional Postcode API | Address Agent |
|---|---|---|
| Input format | Exact postcode required | Plain English, partial addresses, postcodes — anything |
| Typo handling | Returns 404 on any misspelling | Resolves "Downning Stret" to canonical "Downing Street" |
| Response type | Raw PAF record array — developer must parse | Business-ready: valid, canonical address, confidence, geocode |
| Uncertainty communication | None — success or error only | Explicit confidence score: HIGH / MEDIUM / LOW |
| Context across requests | Stateless — every call independent | Conversation memory — resolves "same postcode as before" |
| Geocode included | Separate API call required | Included in every validated response |
| Fraud signal detection | Not available | Returns fraud_signals array: IP mismatch, disposable email, invalid phone |
| Delivery risk scoring | Not available | Returns delivery_risk: LOW / MEDIUM / HIGH aggregated from all signals |
| Address enrichment | Raw address fields only | Returns address_type, geocode, district, fraud signals, and risk score |
| Business address detection | Not available | Identifies residential vs. commercial in single call |
| Partial address resolution | Not supported — requires full postcode | "Buckingham Palace, London" resolves to full canonical address |
| Integration complexity | Chain 3–4 APIs: lookup + geocode + parse + validate | Single endpoint replaces all — one POST request |
| Non-developer access | Requires code — not usable by analysts or ops teams | Natural language interface — anyone can query |
HOW TO START
Sign up with an email and password. No credit card. Your Address Agent key is created instantly with 20 free validation requests.
Free Sign UpPOST an address to agent.apitier.com/v1/validate. You get back a validated, geocoded, confidence-scored result in under 2 seconds.
Purchase request credits. No monthly subscription. No minimum commitment. Scale from 50 to 36,000 validations.
View PricingBrowse address formats, postal code structures, and live demos for 120+ countries.
INTEGRATION
A single POST request. Works in any language. No SDK required.
curl -X POST \
"https://agent.apitier.com/v1/validate?x-api-key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "address": "10 Downing Street", "postcode": "SW1A 2AA" }'
# Response — Royal Mail PAF confirmed
{
"valid": true,
"confidence": "high",
"canonical_address": "10 Downing Street, Westminster, London, SW1A 2AA",
"postcode": "SW1A 2AA",
"district": "Westminster",
"geocode": { "latitude": 51.503, "longitude": -0.127 },
"delivery_risk": "low",
"fraud_signals": [],
"message": "Address confirmed at building level against Royal Mail PAF."
}FAQ
What is the Address Agent?
The Address Agent is an AI-powered global address validation service. You send any address in plain English — UK or international, with or without a postcode — and receive a verified, geocoded, confidence-scored result in a single API call. It replaces traditional postcode APIs with an intelligent, conversational interface covering 120+ countries.
Does it work for international addresses outside the UK?
Yes — 120+ countries are supported. The agent automatically routes UK addresses (detected by postcode format) to Royal Mail PAF for building-level confirmation. All other countries route to OpenStreetMap data. The response schema is identical for both — your integration code does not need to change per country.
Do I need to specify the country in my API request?
No. The agent detects the country automatically from the address text. If the address contains a UK postcode format (e.g. SW1A 2AA), it routes to Royal Mail PAF. For everything else — US ZIP codes, German PLZ, French codes, Indian PIN codes — it routes to global geocoding. You never need to pass a country parameter.
How does the confidence score work for global addresses?
For global addresses, confidence maps to the geocoding precision returned by OpenStreetMap geocoding: HIGH means the result matched at building or street level. MEDIUM means it matched at city or postcode level only. LOW means the match was at county, state, or country level — a broad match that should trigger manual review. For UK addresses, HIGH means the exact building was confirmed in Royal Mail PAF.
Which data sources are used for global addresses?
International address validation uses OpenStreetMap data. Results carry attribution "© OpenStreetMap contributors" under the ODbL licence. Your application must display this attribution. UK addresses continue to use Royal Mail PAF as the primary source.
Are UK-specific enrichment fields (flood risk, deprivation index) available for global addresses?
No. flood_risk, deprivation_index, and broadband_coverage are UK-specific fields populated from our UK open data DynamoDB tables. These fields return null for non-UK addresses. All other fields — geocode, confidence, canonical_address, fraud_signals, delivery_risk, contact validation — work identically for global addresses.
Can I use this for international e-commerce checkout validation?
Yes. The Address Agent is designed for cross-border checkout flows. It validates addresses in the customer's country, detects IP geolocation mismatches (a cross-border fraud signal), validates email and phone, and returns a delivery risk score — all in one POST request. The caller never needs to know which country the address is in.
How is this different from a traditional UK postcode API?
Traditional postcode APIs are UK-only and require an exact postcode input. The Address Agent accepts natural language, handles typos, works globally, and returns geocode and district data in every response with explicit confidence scoring — all in a single API call that replaces 3–4 traditional API calls.
What data source does the Address Agent use for UK addresses?
UK address validation is grounded in the Royal Mail Postcode Address File (PAF) — the definitive UK address dataset used by carriers, banks, and government. Geographic metadata (district, ward, county, geocode) comes from ONS National Statistics Postcode Lookup (NSPL).
What pricing plans are available?
All new accounts get 20 free validation requests with no card required. After that, Pay-As-You-Go plans start from £9 for 50 requests. There is no monthly subscription and no minimum commitment. Credits never expire within their 12-month validity window. UK and global requests are charged at the same rate.
Is there an SLA for the Address Agent?
Yes. The Address Agent is hosted on AWS (EU-West-1) with 99.9% uptime SLA. Response times are under 2 seconds at the 95th percentile for both UK and global address requests.
Can I use this in a mobile app or frontend application?
Yes, but we recommend calling the API from your backend to protect your API key. Use our domain whitelist feature to restrict usage to your application domain. The API is CORS-enabled for approved domains.