Real-time international address capture and validation — autocomplete, typedown, single-line, lookup and validate search types across 245+ countries, with custom layouts, prompt sets, dataset discovery and what3words reverse geocoding.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/address-validation"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
{
"openapi": "3.0.4",
"info": {
"title": "Address Validation",
"version": "v2"
},
"servers": [
{
"url": "https://api.experianaperture.io/"
}
],
"paths": {
"/address/datasets/v1": {
"get": {
"tags": [
"Address Validation"
],
"summary": "Get the available datasets for the supplied country.",
"parameters": [
{
"name": "Reference-Id",
"in": "header",
"description": "Optional identifier that will be returned in the response to help you track the request.",
"schema": {
"maxLength": 256,
"minLength": 0,
"pattern": "^[\\w\\-\\/\\:\\.\\,\\(\\) ]+$",
"type": "string"
}
},
{
"name": "Timeout-Seconds",
"in": "header",
"description": "Maximum time you are prepared to wait for a response, expressed in seconds. Acceptable values: 2-15. If a timeout occurs, an HTTP status code of 408 - Request Timeout will be returned.",
"schema": {
"maximum": 15,
"minimum": 2,
"type": "integer",
"format": "int32"
}
},
{
"name": "country_iso",
"in": "query",
"description": "3-letter ISO code for country.",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AddressDatasetsV1Response"
},
"examples": {
"Australia": {
"value": {"result":[{"country_iso_3":"AUS","country_name":"Australia","datasets":[{"id":"au-address","name":"Australia Postal Address"},{"id":"au-address-beta","name":"Australia Postal Address"},{"id":"au-address-datafusion","name":"Australia Enhanced Address"},{"id":"au-address-gnaf","name":"Australia Geocoded National Address"},{"id":"au-address-gnaf-beta","name":"Australia Geocoded National Address"}]}]}
},
"United Kingdom": {
"value": {"result":[{"country_iso_3":"GBR","country_name":"United Kingdom","datasets":[{"id":"gb-additional-addressbaseislands","name":"United Kingdom AddressBase Premium with Islands"},{"id":"gb-additional-business","name":"United Kingdom Business Names"},{"id":"gb-additional-businessextended","name":"United Kingdom Extended Business"},{"id":"gb-additional-electricity","name":"United Kingdom Live Utilities Data - Electricity"},{"id":"gb-additional-gas","name":"United Kingdom Live Utilities Data - Gas"},{"id":"gb-additional-multipleresidence","name":"United Kingdom Multiple Residence"},{"id":"gb-additional-names","name":"United Kingdom Names"},{"id":"gb-additional-notyetbuilt","name":"United Kingdom Not Yet Built"},{"id":"gb-address","name":"United Kingdom Postal Address"},{"id":"gb-address-addressbase","name":"United Kingdom AddressBase Premium"},{"id":"gb-address-streetlevel","name":"United Kingdom Postal Address Street Level"},{"id":"gb-address-wales","name":"Cymraeg (Welsh Language) Postal Address"}],"valid_combinations":[["gb-additional-business","gb-additional-multipleresidence","gb-additional-notyetbuilt"],["gb-additional-business","gb-additional-names"],["gb-additional-business","gb-additional-names","gb-additional-notyetbuilt"],["gb-additional-business","gb-additional-notyetbuilt"],["gb-additional-multipleresidence","gb-additional-notyetbuilt"],["gb-additional-names","gb-additional-notyetbuilt"]]}]}
},
"United States": {
"value": {"result":[{"country_iso_3":"USA","country_name":"United States of America","datasets":[{"id":"us-address","name":"United States Postal Address"}]}]}
}
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"406": {
"description": "Not Acceptable"
},
"408": {
"description": "Request Timeout"
},
"415": {
"description": "Unsupported Media Type"
},
"429": {
"description": "Too Many Requests"
},
"500": {
"description": "Internal Server Error"
},
"503": {
"description": "Service Unavailable"
}
},
"security": [
{
"OAuth2": [ ]
},
{
"Auth-Token": [ ]
},
{
"x-app-key": [ ]
}
]
}
},
"/address/format/v1/{global_address_key}": {
"get": {
"tags": [
"Address Validation"
],
"summary": "Format the address with the supplied key.",
"parameters": [
{
"name": "Reference-Id",
"in": "header",
"description": "Optional identifier that will be returned in the response to help you track the request.",
"schema": {
"maxLength": 256,
"minLength": 0,
"pattern": "^[\\w\\-\\/\\:\\.\\,\\(\\) ]+$",
"type": "string"
}
},
{
"name": "Timeout-Seconds",
"in": "header",
"description": "Maximum time you are prepared to wait for a response, expressed in seconds. Acceptable values: 2-15. If a timeout occurs, an HTTP status code of 408 - Request Timeout will be returned.",
"schema": {
"maximum": 15,
"minimum": 2,
"type": "integer",
"format": "int32"
}
},
{
"name": "global_address_key",
"in": "path",
"description": "Global address key.",
"required": true,
"schema": {
"maxLength": 4000,
"minLength": 0,
"pattern": "^(?:[A-Za-z0-9_-]*)$",
"type": "string"
}
},
{
"name": "Add-Components",
"in": "header",
"description": "Specifies if the response should contain the address broken down into its components.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "Add-Metadata",
"in": "header",
"description": "Specify whether the response should return all fields and values, in addition to the main core information.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "Add-Dpid",
"in": "header",
"description": "Specify whether the response should return DPID in the metadata result.",
"schema": {
"type": "boolean",
"default": false
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AddressFormatV1Response"
},
"examples": {
"Australia": {
"value": {"result":{"global_address_key":"QVVTfjcuNzMwak9BVVNIQXpsQndBQUFBQUJBd0VBQUFBQk9uQ09FWUFoQUFJUUNDQUFBQUFBQVFBMk5UUTVBRFlBQVAuLlFnQUFBQUQuLi4uLkFBQUFBQUFBQUFBQUFBQUFBQUFBVENBMk5UUTVJRk4wSUV0cGJHUmhJRkprSURVME9RQUFBQUFBfjIy","confidence":"Verified match","address":{"address_line_1":"L 6 549 St Kilda Rd","address_line_2":"","address_line_3":"","locality":"MELBOURNE","region":"VIC","postal_code":"3004","country":"AUSTRALIA"},"components":{"country_name":"AUSTRALIA","country_iso_3":"AUS","country_iso_2":"AU","postal_code":{"full_name":"3004","primary":"3004"},"sub_building":{"floor":{"full_name":"L 6","type":"L","value":"6"}},"building":{"building_number":"549"},"street":{"full_name":"St Kilda Rd","name":"St Kilda","type":"Rd"},"locality":{"town":{"name":"MELBOURNE"}}}},"metadata":{"address_info":{"identifier":{"dpid":"62147712","hin":"203060068"}},"barcode":{"delivery_point_barcode":"1301012002011121210102312002130231113","sort_plan_number":"022"},"address_classification":{"delivery_type":"Business"}}}
},
"United Kingdom": {
"value": {"result":{"global_address_key":"R0JSfjcuNzMwME9HQlJFd3ZsQndBQUFBQUJBd0VBQUFBQWlPLmgwWUFoTUlJQUFBQUFBQUFBTnprQUFQLi5aQUFBQUFELi4uLi5BQUFBQUFBQUFBQUFBQUFBQUFBQU56a2dVM1JoZEdsdmJpQlNiMkZrTENCTFJVeFVXUUFBQUFBQX4yMg","confidence":"Verified match","address":{"address_line_1":"79 Station Road","address_line_2":"","address_line_3":"","locality":"KELTY","region":"","postal_code":"KY4 0BL","country":"UNITED KINGDOM"},"components":{"country_name":"UNITED KINGDOM","country_iso_3":"GBR","country_iso_2":"GB","postal_code":{"full_name":"KY4 0BL","primary":"KY4 0BL"},"building":{"building_number":"79"},"street":{"full_name":"Station Road","name":"Station","type":"Road"},"locality":{"region":{"name":"Scotland","code":"SCT","description":"Constituent country"},"sub_region":{"name":"Fife","description":"Geographic county"},"town":{"name":"KELTY"}},"additional_elements":{"locality":{"sub_region":{"administrative_county":"North Yorkshire","former_postal_county":"North Yorkshire","traditional_county":"Yorkshire"}}}}},"metadata":{"address_info":{"identifier":{"udprn":"12353232","paf_address_key":"2304084100000000S","dps":"1L"}},"barcode":{"delivery_point_barcode":"(KY40BL2Z2)"}}}
},
"United Kingdom with Names": {
"value": {"result":{"global_address_key":"R0JSfjcuNzMwME9HQlJFd3ZsQndBQUFBQUJBd0VBQUFBQWlPLmgwWUFoTUlJQUFBQUFBQUFBTnprQUFQLi5aQUFBQUFELi4uLi5BQUFBQUFBQUFBQUFBQUFBQUFBQU56a2dVM1JoZEdsdmJpQlNiMkZrTENCTFJVeFVXUUFBQUFBQX4yMg","confidence":"Verified match","address":{"address_line_1":"79 Station Road","address_line_2":"","address_line_3":"","locality":"KELTY","region":"","postal_code":"KY4 0BL","country":"UNITED KINGDOM"},"names":[{"firstname":"John","middlename":"James","surname":"Dow"}],"components":{"country_name":"UNITED KINGDOM","country_iso_3":"GBR","country_iso_2":"GB","postal_code":{"full_name":"KY4 0BL","primary":"KY4 0BL"},"building":{"building_number":"79"},"street":{"full_name":"Station Road","name":"Station","type":"Road"},"locality":{"region":{"name":"Scotland","code":"SCT","description":"Constituent country"},"sub_region":{"name":"Fife","description":"Geographic county"},"town":{"name":"KELTY"}},"additional_elements":{"locality":{"sub_region":{"administrative_county":"North Yorkshire","former_postal_county":"North Yorkshire","traditional_county":"Yorkshire"}}}}},"metadata":{"address_info":{"identifier":{"udprn":"12353232","paf_address_key":"2304084100000000S","dps":"2S"}},"barcode":{"delivery_point_barcode":"(KY40BL2Z2)"}}}
},
"United States": {
"value": {"result":{"global_address_key":"VVNBfjcuNzMwck9VU0FEd25sQndBQUFBQUJBZ0VBQUFBRHB4MzJFWUFoSUFJU0NDQUFBQUFBQUFBM053QUEuLjlrQUFBQUFQLi4uLjhBQUFBQUFBQUFBQUFBQUFBQUFBQTNOeUJOWVhOellXTm9kWE5sZEhSeklFRjJaU3d3TWpFek9TMDBNekF4QUFBQUFBQS1-MzE","confidence":"Verified match","address":{"address_line_1":"77 Massachusetts Ave","address_line_2":"","address_line_3":"","locality":"Cambridge","region":"MA","postal_code":"02139-4301","country":"UNITED STATES OF AMERICA"},"components":{"country_name":"UNITED STATES OF AMERICA","country_iso_3":"USA","country_iso_2":"US","postal_code":{"full_name":"02139-4301","primary":"02139","secondary":"4301"},"building":{"building_number":"77"},"street":{"full_name":"Massachusetts Ave","name":"Massachusetts","type":"Ave"},"locality":{"region":{"code":"MA"},"sub_region":{"name":"Middlesex"},"town":{"name":"Cambridge"}}}},"metadata":{"barcode":{"delivery_point_barcode":"02139430177","check_digit":"3"},"route_classification":{"carrier_route":"C077","elot":"0184A"},"address_classification":{"address_type":{"code":"S","description":"Street"},"delivery_type":"Business","is_deliverable":"Y"},"dpv":{"cmra_indicator":"N","seed_indicator":" ","dpv_indicator":"Y","footnotes":["AA","BB"],"vacancy_indicator":"N","no_stats_indicator":"Y","pbsa_indicator":"N","lacs_indicator":" ","lacs_code":""}}}
}
}
}
}
},
"400": {
"description": "Bad Request"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"406": {
"description": "Not Acceptable"
},
"408": {
"description": "Request Timeout"
},
"415": {
"description": "Unsupported Media Type"
},
"429": {
"description": "Too Many Requests"
},
"500": {
"description": "Internal Server Error"
},
"503": {
"description": "Service Unavailable"
}
},
"security": [
{
"OAuth2": [ ]
},
{
"Auth-Token": [ ]
},
{
"x-app-key": [ ]
}
]
},
"post": {
"tags": [
"Address Validation"
],
"summary": "Format the address with the supplied key using a custom layout.",
"parameters": [
{
"name": "Reference-Id",
"in": "header",
"description": "Optional identifier that will be returned in the response to help you track the request.",
"schema": {
"maxLength": 256,
"minLength": 0,
"pattern": "^[\\w\\-\\/\\:\\.\\,\\(\\) ]+$",
"type": "string"
}
},
{
"name": "Timeout-Seconds",
"in": "header",
"description": "Maximum time you are prepared to wait for a response, expressed in seconds. Acceptable values: 2-15. If a timeout occurs, an HTTP status code of 408 - Request Timeout will be returned.",
"schema": {
"maximum": 15,
"minimum": 2,
"type": "integer",
"format": "int32"
}
},
{
"name": "global_address_key",
"in": "path",
"description": "Global address key.",
"required": true,
"schema": {
"maxLength": 4000,
"minLength": 0,
"pattern": "^(?:[A-Za-z0-9_-]*)$",
"type": "string"
}
},
{
"name": "Add-Components",
"in": "header",
"description": "Specifies if the response should contain the address broken down into its components.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "Add-Metadata",
"in": "header",
"description": "Specify whether the response should return all fields and values, in addition to the main core information.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "Add-Enrichment",
"in": "header",
"description": "Specify whether the response should make a call to enrichment and return enrichment result.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "Add-Dpid",
"in": "header",
"description": "Specify whether the response should return DPID in the metadata result.",
"schema": {
"type": "boolean",
"default": false
}
}
],
"requestBody": {
"description": "The request body.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AddressFormatV1Request"
},
"examples": {
"Default Format": {
"value": {"layouts":["default"],"layout_format":"default"}
},
"Default Format With Enrichment": {
"value": {"layouts":["default"],"layout_format":"default","attributes":{"geocodes":["latitude","longitude","match_level"]}}
},
"United Kingdom Business With Enrichment": {
"value": {"layout_format":"default","attributes":{"gbr_business":["commercial_mosaic","location","non_limited_company_key","number_of_employees","phone","registration","standard_industry_classification","urn"]}}
},
"United Kingdom With Mosaic": {
"value": {"layout_format":"default","attributes":{"gbr_mosaic":["household","postal_code"]}}
},
"United Kingdom With Location Grid": {
"value": {"layout_format":"default","attributes":{"gbr_location_grid":["postzon","codepoint"]}}
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AddressFormatV1Response"
},
"examples": {
"Australia": {
"value": {"result":{"global_address_key":"aWQ9TGV2ZWwgNiAgNTQ5IFN0IEtpbGRhIFJvYWQsIE1FTEJPVVJORSAgVklDIDMwMDQsIEF1c3RyYWxpYX5hbHRfa2V5PTYyMTQ3NzEyfmRhdGFzZXQ9QVVTX1BBRn5mb3JtYXRfa2V5PUFVUyRhdS1hZGRyZXNzJDcuNzMwMU9BVVNIQXZtQndBQUFBQUlBZ0VBQUFBQlBlTlNFQWdoQUFJQUFBQUFBQUFBTmdBQS4uOWRBQUFBQVAuLi4uOEFBQUFBQUFBQUFBQUFBQUFBQUFCTUlEWWdJRFUwT1NCVGRDQkxhV3hrWVNCU1pBQUFBQUFBJCQk","confidence":"Verified match","address":{"address_line_1":"L 6 549 St Kilda Rd","address_line_2":"","address_line_3":"","locality":"MELBOURNE","region":"VIC","postal_code":"3004","country":"AUSTRALIA"},"components":{"country_name":"AUSTRALIA","country_iso_3":"AUS","country_iso_2":"AU","postal_code":{"full_name":"3004","primary":"3004"},"sub_building":{"floor":{"full_name":"L 6","type":"L","value":"6"}},"building":{"building_number":"549"},"street":{"full_name":"St Kilda Rd","name":"St Kilda","type":"Rd"},"locality":{"town":{"name":"MELBOURNE"}}}},"metadata":{"address_info":{"identifier":{"dpid":"62147712","hin":"203060068"}},"barcode":{"delivery_point_barcode":"1301012002011121210102312002130231113","sort_plan_number":"022"},"address_classification":{"delivery_type":"Business"}}}
},
"Australia With Enrichment": {
"value": {"result":{"global_address_key":"aWQ9TGV2ZWwgNiAgNTQ5IFN0IEtpbGRhIFJvYWQsIE1FTEJPVVJORSAgVklDIDMwMDQsIEF1c3RyYWxpYX5hbHRfa2V5PTYyMTQ3NzEyfmRhdGFzZXQ9QVVTX1BBRn5mb3JtYXRfa2V5PUFVUyRhdS1hZGRyZXNzJDcuNzMwMU9BVVNIQXZtQndBQUFBQUlBZ0VBQUFBQlBlTlNFQWdoQUFJQUFBQUFBQUFBTmdBQS4uOWRBQUFBQVAuLi4uOEFBQUFBQUFBQUFBQUFBQUFBQUFCTUlEWWdJRFUwT1NCVGRDQkxhV3hrWVNCU1pBQUFBQUFBJCQk","confidence":"Verified match","address":{"address_line_1":"L 6 549 St Kilda Rd","address_line_2":"","address_line_3":"","locality":"MELBOURNE","region":"VIC","postal_code":"3004","country":"AUSTRALIA"},"components":{"country_name":"AUSTRALIA","country_iso_3":"AUS","country_iso_2":"AU","postal_code":{"full_name":"3004","primary":"3004"},"sub_building":{"floor":{"full_name":"L 6","type":"L","value":"6"}},"building":{"building_number":"549"},"street":{"full_name":"St Kilda Rd","name":"St Kilda","type":"Rd"},"locality":{"town":{"name":"MELBOURNE"}}}},"metadata":{"address_info":{"identifier":{"dpid":"62147712","hin":"203060068"}},"barcode":{"delivery_point_barcode":"1301012002011121210102312002130231113","sort_plan_number":"022"},"address_classification":{"delivery_type":"Business"}},"enrichment":{"transaction_id":"23918140-4df9-4862-aaca-db81dd757c52","result":{"geocodes":{"latitude":-37.84659,"longitude":144.98028,"match_level":"building"}},"metadata":{"code":"S200","message":"Success","detail":"All requested attribute(s) retrieved.","datasets":{"geocodes":{"latitude":{"code":"S200","message":"Match","value":"-37.84659"},"longitude":{"code":"S200","message":"Match","value":"144.98028"},"match_level":{"code":"S200","message":"Match","value":"building"}}}}}}
},
"United Kingdom": {
"value": {"result":{"global_address_key":"aWQ9RmxhdCAxLCAyMSBBYmVyZGVlbiBXYWxrLCBTY2FyYm9yb3VnaCwgWU8xMSAxQkEsIFVuaXRlZCBLaW5nZG9tfmFsdF9rZXk9NTQ0Nzc3OTh-ZGF0YXNldD1HQlJfUEFGfmZvcm1hdF9rZXk9R0JSJGdiLWFkZHJlc3MkNmFmZWFhMWMtNTZkYS00YzA4LThmZTQtYTNkOTlhYWI5MTI0JDIxJCQ","confidence":"Verified match","address":{"address_line_1":"Flat 1","address_line_2":"21 Aberdeen Walk","address_line_3":"","locality":"SCARBOROUGH","region":"","postal_code":"YO11 1BA","country":"UNITED KINGDOM"},"components":{"country_name":"UNITED KINGDOM","country_iso_3":"GBR","country_iso_2":"GB","postal_code":{"full_name":"YO11 1BA","primary":"YO11 1BA"},"sub_building":{"door":{"full_name":"Flat 1"}},"building":{"building_number":"21"},"street":{"full_name":"Aberdeen Walk","name":"Aberdeen","type":"Walk"},"locality":{"region":{"name":"Scotland","code":"SCT","description":"Constituent country"},"sub_region":{"name":"Fife","description":"Geographic county"},"town":{"name":"Scarborough"}},"additional_elements":{"locality":{"sub_region":{"administrative_county":"North Yorkshire","former_postal_county":"North Yorkshire","traditional_county":"Yorkshire"}}}}},"metadata":{"address_info":{"identifier":{"udprn":"54477798","paf_address_key":"3890873300000000S","dps":"1A"}},"address_classification":{"delivery_type":"residential"}}}
},
"United Kingdom With Utilities": {
"value": {"result":{"global_address_key":"aWQ9MSBTdXNzZXggQ2xvc2UsIEJPVVJORU1PVVRIIEJIOSAzU0EsIFVuaXRlZCBLaW5nZG9tfmFsdF9rZXk9MDE4MjcxNzN-ZGF0YXNldD1HQlJ-Zm9ybWF0X2tleT1HQlIkR0JSJDcuNzMwZU9HQlJFd2ZvQndBQUFBQUJBd0VBQUFBQVpOSElrWUFnQUFBQUFBQUFNUUFBLi45a0FBQUFBUC4uLi44QUFBQUFBQUFBQUFBQUFBQUFBQUF4SUZOMWMzTmxlQ0JEYkc5elpRQUFBQUFBfmVsZWM9dHJ1ZX5nYXM9dHJ1ZX5wb3M9MX5nYWtfdHlwZT1zaW5nbGVsaW5lflFMPTE0fm1heF9zdWdnZXN0aW9ucz03","confidence":"Verified match","addresses_formatted":[{"layout_name":"Utilities","address":{"address_line_1":"1 Sussex Close","address_line_2":"","address_line_3":"","locality":"Bournemouth","region":"","postal_code":"BH9 3SA","country":"United Kingdom","electricity_meters":[{"mpan":"12345678910","uprn":"123456789","address_line_1":"","address_line_2":"","address_line_3":"1","address_line_4":"","address_line_5":"Sussex Close","address_line_6":"","address_line_7":"","address_line_8":"BOURNEMOUTH","address_line_9":"","address_postal_code":"BH9 3SA","trading_status":"T","trading_status_efd":"20040121","profile_class":"01","profile_class_efd":"1234567","meter_timeswitch_class":"123","meter_timeswitch_class_efd":"7654321","line_loss_factor":"100","line_loss_factor_efd":"7654321","standard_settlement_configuration":"0393","standard_settlement_configuration_efd":"7654321","energisation_status":"E","energisation_status_efd":"20040121","gsp_group_id":"_H","gsp_group_efd":"20040121","data_aggregator_mpid":"MANW","data_aggregator_efd":"20040121","data_collector_mpid":"MANW","data_collector_efd":"20040121","supplier_mpid":"","supplier_efd":"","meter_operator_mpid":"","meter_operator_efd":"","measurement_class":"A","measurement_class_efd":"20040121","green_deal_in_effect":"0","smso_mpid":"","smso_efd":"","dcc_service_flag":"","dcc_service_flag_efd":"","ihd_status":"","ihd_status_efd":"","smets_version":"","distributor_mpid":"SOUT","metered_indicator":"","metered_indicator_efd":"","metered_indicator_etd":"20040121","consumer_type":"Domestic","relationship_status_indicator":"None","rmp_state":"O","rmp_efd":"20040121","domestic_consumer_indicator":"T","css_supplier_mpid":"","css_supply_start_date":"","meter_serial_number":"1234567T","meter_install_date":"20040121","meter_type":"N","map_mpid":"SOUT","map_mpid_efd":"20040121","installing_supplier_mpid":"SPOW","energy_direction":"","energy_direction_efd":"","energy_direction_etd":"","connection_type":"","connection_type_efd":"","connection_type_etd":"","esme_id":"","meter_location":"","register_digits":"","rel_address_primary_name":"1","rel_address_secondary_name":"","rel_address_street1":"SUSSEX CLOSE","rel_address_street2":"","rel_address_locality1":"","rel_address_locality2":"","rel_address_town":"BOURNEMOUTH","rel_address_postcode":"BH9 3SA","rel_address_logical_status":"1","rel_address_language":"ENG","rel_address_organisation":"","rel_address_address_type":"DPA","rel_address_confidence_score":"100","rel_address_classification":"RD02","rel_address_latitude":"50.763416","rel_address_longitude":"-1.860534"}],"gas_meters":[{"mprn":"9876543210","uprn":"987654321","rel_address_primary_name":"1","rel_address_secondary_name":"","rel_address_street1":"SUSSEX CLOSE","rel_address_street2":"","rel_address_locality1":"","rel_address_locality2":"","rel_address_town":"BOURNEMOUTH","rel_address_postcode":"BH9 3SA","rel_address_logical_status":"1","rel_address_language":"ENG","rel_address_organisation":"","rel_address_address_type":"DPA","rel_address_confidence_score":"100","rel_address_classification":"RD02","rel_address_latitude":"50.763416","rel_address_longitude":"-1.860534","meter_serial":"G4K0012345678","offtake_quantity_annual":"01234","meter_point_status":"LI","installer_id":"SCT","network_name":"Scotland Gas Networks Plc.","supplier_name":"Scottish Power Energy Retail Limited","last_meter_read_date":"20240517","last_meter_read_type":"E","last_meter_read_value":"01187"}]}}]}}
},
"United Kingdom With Electricity and MOSAIC HH Elements": {
"value": {"result":{"global_address_key":"aWQ9MSBTdXNzZXggQ2xvc2UsIEJPVVJORU1PVVRIIEJIOSAzU0EsIFVuaXRlZCBLaW5nZG9tfmFsdF9rZXk9MDE4MjcxNzN-ZGF0YXNldD1HQlJ-Zm9ybWF0X2tleT1HQlIkR0JSJDcuNzMwZU9HQlJFd2ZvQndBQUFBQUJBd0VBQUFBQVpOSElrWUFnQUFBQUFBQUFNUUFBLi45a0FBQUFBUC4uLi44QUFBQUFBQUFBQUFBQUFBQUFBQUF4SUZOMWMzTmxlQ0JEYkc5elpRQUFBQUFBfmVsZWM9dHJ1ZX5nYXM9dHJ1ZX5wb3M9MX5nYWtfdHlwZT1zaW5nbGVsaW5lflFMPTE0fm1heF9zdWdnZXN0aW9ucz03","confidence":"Verified match","addresses_formatted":[{"layout_name":"ElectricityUtilityMosaicHousehold","address":{"address_line_1":"1 Sussex Close","address_line_2":"","address_line_3":"","locality":"Bournemouth","region":"","postal_code":"BH9 3SA","country":"United Kingdom","mosaic_household_type_code":"32","mosaic_household_type_name":"First-Rung Futures","mosaic_household_group_code":"H","mosaic_household_group_name":"Aspiring Homemakers","electricity_meters":[{"mpan":"12345678910","uprn":"123456789","address_line_1":"","address_line_2":"","address_line_3":"1","address_line_4":"","address_line_5":"Sussex Close","address_line_6":"","address_line_7":"","address_line_8":"BOURNEMOUTH","address_line_9":"","address_postal_code":"BH9 3SA","trading_status":"T","trading_status_efd":"20040121","profile_class":"01","profile_class_efd":"1234567","meter_timeswitch_class":"123","meter_timeswitch_class_efd":"7654321","line_loss_factor":"100","line_loss_factor_efd":"7654321","standard_settlement_configuration":"0393","standard_settlement_configuration_efd":"7654321","energisation_status":"E","energisation_status_efd":"20040121","gsp_group_id":"_H","gsp_group_efd":"20040121","data_aggregator_mpid":"MANW","data_aggregator_efd":"20040121","data_collector_mpid":"MANW","data_collector_efd":"20040121","supplier_mpid":"","supplier_efd":"","meter_operator_mpid":"","meter_operator_efd":"","measurement_class":"A","measurement_class_efd":"20040121","green_deal_in_effect":"0","smso_mpid":"","smso_efd":"","dcc_service_flag":"","dcc_service_flag_efd":"","ihd_status":"","ihd_status_efd":"","smets_version":"","distributor_mpid":"SOUT","metered_indicator":"","metered_indicator_efd":"","metered_indicator_etd":"20040121","consumer_type":"Domestic","relationship_status_indicator":"None","rmp_state":"O","rmp_efd":"20040121","domestic_consumer_indicator":"T","css_supplier_mpid":"","css_supply_start_date":"","meter_serial_number":"1234567T","meter_install_date":"20040121","meter_type":"N","map_mpid":"SOUT","map_mpid_efd":"20040121","installing_supplier_mpid":"SPOW","energy_direction":"","energy_direction_efd":"","energy_direction_etd":"","connection_type":"","connection_type_efd":"","connection_type_etd":"","esme_id":"","meter_location":"","register_digits":"","rel_address_primary_name":"1","rel_address_secondary_name":"","rel_address_street1":"SUSSEX CLOSE","rel_address_street2":"","rel_address_locality1":"","rel_address_locality2":"","rel_address_town":"BOURNEMOUTH","rel_address_postcode":"BH9 3SA","rel_address_logical_status":"1","rel_address_language":"ENG","rel_address_organisation":"","rel_address_address_type":"DPA","rel_address_confidence_score":"100","rel_address_classification":"RD02","rel_address_latitude":"50.763416","rel_address_longitude":"-1.860534"}]}}]}}
},
"United Kingdom With Enrichment": {
"value": {"result":{"global_address_key":"aWQ9RmxhdCAxLCAyMSBBYmVyZGVlbiBXYWxrLCBTY2FyYm9yb3VnaCwgWU8xMSAxQkEsIFVuaXRlZCBLaW5nZG9tfmFsdF9rZXk9NTQ0Nzc3OTh-ZGF0YXNldD1HQlJfUEFGfmZvcm1hdF9rZXk9R0JSJGdiLWFkZHJlc3MkNmFmZWFhMWMtNTZkYS00YzA4LThmZTQtYTNkOTlhYWI5MTI0JDIxJCQ","confidence":"Verified match","address":{"address_line_1":"Flat 1","address_line_2":"21 Aberdeen Walk","address_line_3":"","locality":"SCARBOROUGH","region":"","postal_code":"YO11 1BA","country":"UNITED KINGDOM"},"components":{"country_name":"UNITED KINGDOM","country_iso_3":"GBR","country_iso_2":"GB","postal_code":{"full_name":"YO11 1BA","primary":"YO11 1BA"},"sub_building":{"door":{"full_name":"Flat 1"}},"building":{"building_number":"21"},"street":{"full_name":"Aberdeen Walk","name":"Aberdeen","type":"Walk"},"locality":{"region":{"name":"Scotland","code":"SCT","description":"Constituent country"},"sub_region":{"name":"Fife","description":"Geographic county"},"town":{"name":"Scarborough"}},"additional_elements":{"locality":{"sub_region":{"administrative_county":"North Yorkshire","former_postal_county":"North Yorkshire","traditional_county":"Yorkshire"}}}}},"metadata":{"address_info":{"identifier":{"udprn":"54477798","paf_address_key":"3890873300000000S","dps":"1A"}},"address_classification":{"delivery_type":"residential"}},"enrichment":{"transaction_id":"70ac71c8-bad1-4d7e-9e21-f1405d0647a4","result":{"geocodes":{"latitude":54.2828,"longitude":-0.40269,"match_level":"building"}},"metadata":{"code":"S200","message":"Success","detail":"All requested attribute(s) retrieved.","datasets":{"geocodes":{"latitude":{"code":"S200","message":"Match","value":"54.2828"},"longitude":{"code":"S200","message":"Match","value":"-0.40269"},"match_level":{"code":"S200","message":"Match","value":"building"}}}}}}
},
"United Kingdom With Business Enrichment": {
"value": {"result":{"confidence":"Verified match","address":{"address_line_1":"Example Business","address_line_2":"Business Name","address_line_3":"5-7 Cutler Street","locality":"LONDON","region":"","postal_code":"E1 7DJ","country":"UNITED KINGDOM"},"components":{"country_name":"UNITED KINGDOM","country_iso_3":"GBR","country_iso_2":"GB","postal_code":{"full_name":"KY4 0BL","primary":"KY4 0BL"},"building":{"building_name":"Business Name","building_number":"79"},"street":{"full_name":"Cutler Street","name":"Cutler","type":"Street"},"locality":{"region":{"name":"England","code":"ENG","description":"Constituent country"},"sub_region":{"name":"Greater London","description":"Georgraphic county"},"town":{"name":"KELTY"}}}},"metadata":{"address_info":{"identifier":{"udprn":"12353232","paf_address_key":"2304084100000000S","dps":"1L"}},"barcode":{"delivery_point_barcode":"(KY40BL2Z2)"}},"enrichment":{"transaction_id":"00000000-0000-0000-0000-000000000000","result":{"gbr_business":{"urn":"Tlt00004518123","commercial_mosaic":{"group_type_code":"K41","group_type_description":"Business Boosters","group_
# --- truncated at 32 KB (459 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/experian/refs/heads/main/openapi/experian-addressvalidation-openapi.json