United Kingdom

The United Kingdom dataset is essential for organizations that rely on precise and validated address data. It supports a wide range of applications including address verification, data cleansing, customer onboarding, fraud prevention, and logistics optimization. Businesses use PAF to reduce failed deliveries, improve customer experience, and streamline operations. It also plays a critical role in e-commerce, financial services, utilities, and public sector services by enabling accurate identification and communication with individuals and businesses.

The United Kingdom dataset is often used in conjunction with additional datasets like Multiple Residence and Not Yet Built to provide even deeper insights into UK addresses. Its reliability and comprehensiveness make it a cornerstone of address management and data quality solutions across industries.

Include gb-address in the datasets array within your /Search, /Validate or /Lookup request. See an example of a partial /Search request and response structure below.

{
  "country_iso": "GBR",
  "components": {
    "unspecified": [
      "1 main"
    ]
  },
  "datasets": [ "gb-address" ]
}

{
  "result": {
    "more_results_available": boolean,
    "confidence": "string",
    "suggestions": [
      {
        "global_address_key": "string",
        "text": "string",
        "matched": [[integer, integer]],
        "format": "string"
      }
    ]
  }
}

United Kingdom Location Essential represents a comprehensive location dataset enabling you to combine Royal Mail's Postal Address File (PAF) with a unique numeric identifier (UPRN) for every addressable location in Great Britain (England, Scotland, and Wales). You can append British National Grid's easting and northing coordinates, and building roof top latitude and longitude information from Ordnance Survey to your validated addresses. As such, it enables customers to precisely pinpoint the physical location of a given address on a map.

This dataset does not include addresses from Isle of Man, Channel Islands or Northern Ireland.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the uk_location_essential Enrichment set below.

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the uk_location_essential object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "uk_location_essential": [
            "latitude",
            "longitude",
            "match_level",
            "udprn",
            "uprn",
            "x_coordinate",
            "y_coordinate"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "uk_location_essential": {
                "latitude": double,
                "longitude": double,
                "match_level": "string",
                "udprn": "string",
                "uprn": "string",
                "x_coordinate": double,
                "y_coordinate": double
            }
        }
    }
}

United Kingdom Location Complete represents a comprehensive location dataset enabling you to combine Royal Mail's Postal Address File (PAF) with a unique numeric identifier (UPRN) for every addressable location in Great Britain (England, Scotland, and Wales). You can append British National Grid's easting and northing coordinates, and building roof top latitude and longitude information from Ordnance Survey to your validated addresses. As such, it enables customers to precisely pinpoint the physical location of a given address on a map.

This dataset includes addresses from Isle of Man, Channel Islands, and Northern Ireland.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the uk_location_complete Enrichment set below.

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the uk_location_complete object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "uk_location_complete": [
            "latitude",
            "longitude",
            "match_level",
            "udprn",
            "uprn",
            "x_coordinate",
            "y_coordinate"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "uk_location_complete": {
                "latitude": double,
                "longitude": double,
                "match_level": "string",
                "udprn": "string",
                "uprn": "string",
                "x_coordinate": double,
                "y_coordinate": double
            }
        }
    }
}

Postzon

Coordinate Enrichment set that returns a grid reference for a postal code in Great Britain with a resolution of 100m. All returned grid coordinates have a total of 10 digits (5 digit Easting, 5 digit Northing), with leading zeros where necessary. However, some parts of the North of Great Britain can have a leading 1.

The returned grid reference is the closest to the centroid property in the address postal code. There are no 100m grid references for the Channel Islands or the Isle of Man.

CodePoint

Coordinate Enrichment set that returns a unique national grid coordinate for each postal code in Great Britain to a resolution of 1 metre. The grid reference given is that of the centroid property in the postal code. Values are returned to a resolution of 1m. Grid resolution refers to a property being within the 1m grid sector box, anchored in the bottom lefthand corner by a grid reference. So, the property can be anywhere within that 1m grid sector box.

All grid coordinates have a total of 14 digits (7 digits Easting, 7 digits Northing). However, 6 digit Eastings and Northings may also be returned, as leading zeros are removed. CodePoint includes the 121 postal code areas in England, Scotland, Wales and Northern Ireland, but does not include postal code areas for the Isle of Man or the Channel Islands.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_location_grid Enrichment set below.

Postzon element

CodePoint element

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_location_grid object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_location_grid": [
            "postzon",
            "codepoint"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_location_grid": {
                "postzon": {
                    "x_coordinate": double,
                    "y_coordinate": double,
                    "os_x_coordinate": double,
                    "os_y_coordinate": double,
                    "latitude": double,
                    "longitude": double,
                    "os_landranger": "string",
                },
                "codepoint": {
                    "x_coordinate": double,
                    "y_coordinate": double,
                    "pqi": "string",
                    "is_delivery_service": "string",
                    "ndp": "string",
                    "ndp_pqi": "string",
                    "ndp_domestic": "string",
                    "ndp_commercial": "string",
                    "ndp_delivery_service": "string",
                    "ndp_matched": "string",
                    "ndp_unmatched": "string"
                }
            }
        }
    }
}

Aliases

Aliases are alternative address elements or names that Royal Mail holds in addition to official postal addresses. They are not required for successful mail delivery but can be helpful for historical reasons, locality preferences, or when businesses operate from home.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_alias Enrichment set below.

Aliases element

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_alias object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_alias": [
            "aliases"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_alias": {
                "aliases": {
                    "building_name": "string",
                    "also_known_as": "string",
                    "department": "string",
                    "organization_description": "string",
                    "organization_at_residential": "string",
                    "trading_name": "string",
                    "misc": "string",
                    "welsh_alternative": "string",
                }
            }
        }
    }
}

A Local Authority Electoral Ward is the lowest denominator of administrative boundary division. The size of a Ward is decided to ensure 'Electoral Equality'. This is the belief that each elector should have a vote of equal weight. In practice, this means that a rural Ward tends to be much larger, geographically, than an urban Ward, in order that the electors from both have an equal amount of representation by their respective councillors. A Ward can be represented by one or more councillors, and could cover about 2000-4000 people in a rural area, and considerably more people in an urban area.

Census Output Areas (OAs) are the lowest geographical level at which census estimates are provided, each OA contains on average 125 households that tend towards homogeneity. This data was collected during the 2011 UK Census. Please note this field will be blank if the returned address has no grid reference.

Ward boundaries are decided upon by one of the Local Government Commissions working in alliance with the Local Authority, in a Periodic Electoral Review (PER). This Enrichment dataset returns the Ward that covers the majority of the submitted postcode. A small percentage of postcodes are split between two or more Wards.

The data is supplied to Royal Mail by the Office of National Statistics (ONS) every month, who update the Postzon files on a quarterly basis, and supply them to Experian. Typically, most changes occur in February or March, when Local Authority Wards are revised before elections in May.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_government Enrichment set below.

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_government object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_government": [
            "eer_code",
            "eer_name",
            "gor_code",
            "gor_name",
            "la_code",
            "la_name",
            "lea_code",
            "lea_name",
            "ward_code",
            "ward_name",
            "cens_out_area"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_government": {
                "eer_code": "string",
                "eer_name": "string",
                "gor_code": "string",
                "gor_name": "string",
                "la_code": "string",
                "la_name": "string",
                "lea_code": "string",
                "lea_name": "string",
                "ward_code": "string",
                "ward_name": "string",
                "cens_out_area": "string"
            }
        }
    }
}

The Office of National Statistics (ONS) introduced new nine-character codes for geographical areas in January 2011. As of September 2014, the linkage between the old and new formats is no longer provided by the ONS; therefore, some postcodes may not return the old format. The Enrichment set includes both the old and new versions of the NHS Authority, Primary Care Organization, and Local Authority Ward codes.

The organization of the National Health Service (NHS) is different in each of the four countries of the UK. This dataset does not include data for address from Isle of Man or Channel Islands.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_health Enrichment set below.

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_health object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_health": [
            "authority_code_2011",
            "authority_name",
            "pclh_code_2011",
            "pclh_name",
            "ward_code_2011",
            "ward_name",
            "ccg_code",
            "ccg_name",
            "doh_code"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_health": {
                "authority_code_2011": "string",
                "authority_name": "string",
                "pclh_code_2011": "string",
                "pclh_name": "string",
                "ward_code_2011": "string",
                "ward_name": "string",
                "ccg_code": "string",
                "ccg_name": "string",
                "doh_code": "string"
            }
        }
    }
}

Postal_code

The Enrichment set provides MOSAIC 7 segmentation for UK postcode areas, offering a broader view of demographic patterns. It helps businesses:

• Analyze postal code-level trends across England, Scotland, Wales, and Northern Ireland.
• Identify dominant lifestyle groups within geographic regions.
• Support strategic planning, location analysis, and regional marketing efforts.

Perfect for businesses that need area-based segmentation to inform outreach and expansion strategies.

Household

The Enrichment set delivers MOSAIC 7 segmentation for over 26 million UK households. It enables businesses to:

• Profile individual households using 15 Groups and 66 detailed Types.
• Leverage insights from 450+ data variables sourced from Experian, public records, and trusted third parties.
• Understand consumer behavior at the most granular level for personalized marketing and risk assessment.

Ideal for organizations seeking high-resolution targeting and deep consumer understanding.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_mosaic Enrichment set below.

Postal_code element

Household element

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_mosaic object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_mosaic": [
            "postal_code",
            "household"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_mosaic": {
                "postal_code": {
                    "group_code": "string",
                    "group": "string",
                    "type_code": "string",
                    "type": "string"
                },
                "household": {
                    "group_code": "string",
                    "group": "string",
                    "type_code": "string",
                    "type": "string"
                }
            }
        }
    }
}

This Enrichment set is ideal for you if you are involved in public affairs, policy research, regional planning, and civic engagement, offering a reliable foundation for understanding political boundaries and representation across the UK.

Westminster

This dataset returns the name of the parliamentary constituency, the elected Member of Parliament (MP), and their political party for any UK postcode. With around 650 constituencies across the UK, this data reflects the latest boundary definitions maintained by the Boundary Commission, which reviews and adjusts constituency borders every 8–12 years to align with local authority changes.

• Identify the primary constituency for any postal code.
• Access up-to-date MP and party information.
• Support policy analysis, lobbying, and regional engagement strategies.

Scotland

For addresses in Scotland, this dataset provides comprehensive details about Scottish Parliament representation, including:

• The constituency MSP and their party
• The electoral region and its seven regional MSPs, elected via a party list system

Each Scottish address is represented by eight MSPs, offering a complete view of political representation at both constituency and regional levels.

• Understand multi-layered political representation in Scotland.
• Enable region-specific outreach and advocacy.
• Enhance local engagement strategies with accurate political data.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_parliament Enrichment set below.

Westminster element

Scotland element

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_parliament object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_parliament": [
            "westminster",
            "scotland"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_parliament": {
                "westminster": {
                    "constituency_code": "string",
                    "constituency": "string",
                    "mp": "string",
                    "mp_party": "string"
                },
                "scotland": {
                    "constituency_code": "string",
                    "constituency": "string",
                    "region_code": "string",
                    "region": "string",
                    "mp": "string",
                    "mp_party": "string",
                    "regional_msp1": "string",
                    "regional_msp1_party": "string",
                    "regional_msp2": "string",
                    "regional_msp2_party": "string",
                    "regional_msp3": "string",
                    "regional_msp3_party": "string",
                    "regional_msp4": "string",
                    "regional_msp4_party": "string",
                    "regional_msp5": "string",
                    "regional_msp5_party": "string",
                    "regional_msp6": "string",
                    "regional_msp6_party": "string",
                    "regional_msp7": "string",
                    "regional_msp7_party": "string"
                }
            }
        }
    }
}

The Business Names address dataset is particularly valuable for organizations in financial services, insurance, utilities, telecoms, and government sectors, where address-level business intelligence is critical for onboarding, risk assessment, or customer engagement.

Include gb-additional-business in the datasets array within your /Search, /Validate or /Lookup request. See an example of a partial /Search request and response structure below.

{
  "country_iso": "GBR",
  "components": {
    "unspecified": [
      "experian, 1 main"
    ]
  },
  "datasets": [ "gb-additional-business" ]
}

{
  "result": {
    "more_results_available": boolean,
    "confidence": "string",
    "suggestions": [
      {
        "global_address_key": "string",
        "text": "string",
        "matched": [[integer, integer]],
        "format": "string",
        "dataset": "string"
      }
    ]
  }
}

Unlike standard address datasets the Business Enrichment dataset includes registration numbers, industry classifications (SIC), and employee counts. This makes it ideal for distinguishing between residential and commercial premises, supporting more accurate segmentation, targeting, and compliance.

Commercial MOSAIC

Commercial MOSAIC data enables companies to select future business prospects that share similar characteristics to existing customers.

Standard industry classification

Standard Industry Classification (SIC) codes enable businesses to be classified in a uniform way, where each establishment is classified according to its primary activity.

Location

Information of what the particular location is to the business; e.g. "Headquarters".

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_business Enrichment set below.

commercial_mosaic element

standard_industry_classification element

location element

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_business object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_business": [
            "urn",
            "commercial_mosaic",
            "registration",
            "phone",
            "number_of_employees",
            "location",
            "standard_industry_classification",
            "non_limited_company_key"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_business": {
                "urn": "string",
                "commercial_mosaic": {
                    "group_type_code": "string",
                    "group_type_description": "string",
                    "group_code": "string",
                    "group_description": "string",
                }, 
                "registration": "string",
                "non_limited_company_key": "string",
                "phone": "string",
                "number_of_employees": "string",
                "standard_industry_classification": {
                    "sic_2007_code": "string",
                    "sic_2007_description": "string",
                    "thomson_code": "string",
                    "thomson_description": "string"
                },
                "location": {
                    "code": "string",
                    "description": "string",
                    "small_or_home_office": true | false
                }
            }
        }
    }
}

This dataset is essential for applications requiring transparency into data provenance and quality, such as risk assessment, fraud detection, and compliance reporting. By providing detailed match quality scores between Royal Mail data and any additional data sources used in creating the reference dataset, businesses can understand the confidence level of the data fusion process for each address record. Organizations can use these indicators to apply appropriate data handling strategies, implement quality-based business rules, or flag records that may require additional verification due to lower source data matching confidence. The more confident Experian is in the match between the raw data supplied and the PAF address data, the better the match quality that is returned.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_quality Enrichment set below.

Record element

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_quality object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_quality": [
            "record"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_quality": {
                "record": {
                    "address": "string",
                    "postal_code": "string"
                }
            }
        }
    }
}

This dataset holds significant value for organizations that rely on precise address data. By identifying individual residences within shared buildings, it enhances delivery accuracy, reduces failed deliveries, and improves customer satisfaction. It also plays a crucial role in fraud prevention, helping verify residential details and detect inconsistencies that may indicate fraudulent activity. For businesses, it enables more refined customer segmentation and targeting, allowing for personalized communication and marketing efforts.

Industries such as e-commerce, utilities, financial services, healthcare, and the public sector can benefit greatly from the Multiple Residence dataset. E-commerce companies can ensure successful deliveries to flats and shared buildings, while utility providers can accurately bill and plan infrastructure. Financial institutions can strengthen identity verification processes, and public sector organizations can better allocate resources and deliver services to hidden households. Overall, the dataset provides a powerful tool for improving operational efficiency, customer intelligence, and service delivery across a wide range of applications.

Include gb-additional-multipleresidence in the datasets array within your /Search, /Validate or /Lookup request. See an example of a partial /Search request and response structure below.

{
  "country_iso": "GBR",
  "components": {
    "unspecified": [
      "flat 1, 1 main"
    ]
  },
  "datasets": [ "gb-additional-multipleresidence" ]
}

{
  "result": {
    "more_results_available": boolean,
    "confidence": "string",
    "suggestions": [
      {
        "global_address_key": "string",
        "text": "string",
        "matched": [[integer, integer]],
        "format": "string",
        "dataset": "string"
      }
    ]
  }
}

This dataset is essential for applications requiring transparency into data provenance and quality, such as risk assessment, fraud detection, and compliance reporting. By providing detailed match quality scores between Royal Mail data and any additional data sources used in creating the reference dataset, businesses can understand the confidence level of the data fusion process for each address record. Organizations can use these indicators to apply appropriate data handling strategies, implement quality-based business rules, or flag records that may require additional verification due to lower source data matching confidence. The more confident Experian is in the match between the raw data supplied and the PAF address data, the better the match quality that is returned.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_quality Enrichment set below.

Record element

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_quality object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_quality": [
            "record"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_quality": {
                "record": {
                    "address": "string",
                    "postal_code": "string"
                }
            }
        }
    }
}

The Names dataset is particularly beneficial for organizations operating within the UK that require verified consumer identity data for internal marketing purposes. The dataset may be used solely for your own internal use at their UK premises, specifically for marketing client products and associated data quality activities.

Industries such as retail, utilities, financial services, and public sector organizations can benefit from the dataset, provided their use aligns with these constraints. For example, a utility provider may use the data to improve onboarding communications for new customers, while a financial institution might enhance its internal fraud detection systems by validating name and address combinations. All usage must remain within the bounds of internal marketing and data quality improvement, ensuring compliance with Experian's licensing and privacy obligations.

Include gb-additional-names in the datasets array within your /Search request. See an example of a partial /Search request and response structure below.

{
  "country_iso": "GBR",
  "components": {
    "unspecified": [
      "Flat 1, 160 Blackfriars Road, london"
    ]
  },
  "datasets": [ "gb-additional-names" ],
  "options": [
    {
      "name": "search_type",
      "value": "singleline"
    }
  ]
}

{
  "result": {
    "more_results_available": boolean,
    "confidence": "string",
    "suggestions_key": "string",
    "suggestions_prompt": "string",
    "suggestions": [
      {
        "global_address_key": "string",
        "text": "string",
        "format": "string",
        "additional_attributes": [
          {
            "name": "picklist_display",
            "value": "string"
          },
          {
            "name": "score",
            "value": "string"
          },
          {
            "name": "postcode",
            "value": "string"
          },
          {
            "name": "full_address",
            "value": "string"
          }
        ]
      }
    ]
  }
}

This dataset is essential for applications requiring transparency into data provenance and quality, such as risk assessment, fraud detection, and compliance reporting. By providing detailed match quality scores between Royal Mail data and any additional data sources used in creating the reference dataset, businesses can understand the confidence level of the data fusion process for each address record. Organizations can use these indicators to apply appropriate data handling strategies, implement quality-based business rules, or flag records that may require additional verification due to lower source data matching confidence. The more confident Experian is in the match between the raw data supplied and the PAF address data, the better the match quality that is returned.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_quality Enrichment set below.

Record element

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_quality object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_quality": [
            "record"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_quality": {
                "record": {
                    "address": "string",
                    "postal_code": "string"
                }
            }
        }
    }
}

This dataset is particularly valuable for industries that rely on early engagement with new developments. Utilities, telecoms, and retailers can use it to schedule installations and deliveries ahead of occupancy, ensuring seamless service activation. It also supports marketing and customer acquisition strategies by allowing businesses to target future residents and commercial tenants with tailored campaigns. By integrating Not Yet Built data into address validation systems, companies can reduce failed deliveries, improve user experience, and maintain clean, up-to-date databases.

Moreover, the dataset provides a competitive edge by offering insights into emerging markets and development hotspots. You can plan logistics, forecast demand, and allocate resources more effectively. Public sector organizations also benefit by using the data to support infrastructure planning and service delivery in growing communities. Overall, Not Yet Built is a strategic tool for anticipating customer needs and staying ahead of market trends.

Include gb-additional-notyetbuilt in the datasets array within your /Search, /Validate or /Lookup request. See an example of a partial /Search request and response structure below.

{
  "country_iso": "GBR",
  "components": {
    "unspecified": [
      "1 main"
    ]
  },
  "datasets": [ "gb-additional-notyetbuilt" ]
}

{
  "result": {
    "more_results_available": boolean,
    "confidence": "string",
    "suggestions": [
      {
        "global_address_key": "string",
        "text": "string",
        "matched": [[integer, integer]],
        "format": "string",
        "dataset": "string"
      }
    ]
  }
}

This dataset is essential for applications requiring transparency into data provenance and quality, such as risk assessment, fraud detection, and compliance reporting. By providing detailed match quality scores between Royal Mail data and any additional data sources used in creating the reference dataset, businesses can understand the confidence level of the data fusion process for each address record. Organizations can use these indicators to apply appropriate data handling strategies, implement quality-based business rules, or flag records that may require additional verification due to lower source data matching confidence. The more confident Experian is in the match between the raw data supplied and the PAF address data, the better the match quality that is returned.

Each Enrichment dataset is divided into one or more items. Experian Address Validation can be configured to return these items via the Enrichment section. Find detailed information about the available elements for the gbr_quality Enrichment set below.

Record element

Append the attributes object to your /Format or /Validate request and set the Add-Enrichment header. List the attributes you wish to retrieve in the gbr_quality object. All available attributes and full request and response structures are shown below.

{
    ...,
    "attributes": {
        "gbr_quality": [
            "record"
        ]
    }
}

{
    ...,
    "enrichment": {
        "result": {
            "gbr_quality": {
                "record": {
                    "address": "string",
                    "postal_code": "string"
                }
            }
        }
    }
}