Business Verification Rules, Codes, & Messages – Global Data Consortium

Standard Business Message Structure

The table below includes a list of possible data elements and their associated Messages & Codes. Please note that: CERTAIN CODES and MESSAGES ARE ONLY APPLICABLE TO CERTAIN COUNTRIES. Country specific codes and messages are noted in the table. Input elements/Messages in red font color delineate required or suggested input for standard configurations.

*3BZ messages can also indicate data validation and required fields.

Standard Business Verification (BZ) Codes & Messages

Identifying Elements	1BZ Code	1BZ Message
FloorNumber	1BZ-2100-SUBPREMISE	Full match was made on Sub Premise Descriptors provided in Address Lines
HouseExtension	1BZ-2100-SUBPREMISE
HouseNumber	1BZ-2150-HOUSENUMBER	Full match was made on House Number/Street Number
StreetNumber	1BZ-2150-HOUSENUMBER
StreetName	1BZ-2175-THOROUGHFARE	Full match was made on Street/Thoroughfare
Thoroughfare	1BZ-2175-THOROUGHFARE
StreetType	N/A - INCLUDED IN LOGIC FOR STREET/THOROUGHFARE
Home_Address	1BZ-2200-ADDRESS	Full match was made on address elements provided in Address Lines
Address1	1BZ-2200-ADDRESS
Mail_Address	1BZ-2200-ADDRESS
Locality	1BZ-2250-LOCALITY	Full match was made on City/Locality
PostTown - UK	1BZ-2250-LOCALITY
City	1BZ-2250-LOCALITY
Home_City	1BZ-2250-LOCALITY
Mail_City	1BZ-2250-LOCALITY
Suburb – BZ, BR, NZ, ZA	1BZ-2250-LOCALITY
Municipality - CA	1BZ-2250-LOCALITY
PostalCode	1BZ-2275-POSTALCODE	Full match was made on Postal Code/Zip Code
Mail_Zip	1BZ-2275-POSTALCODE
ZipCode	1BZ-2275-POSTALCODE
County – IE	1BZ-2300-COUNTY	Full match was made on County
Province – CA, IT	1BZ-2325-PROVINCE	Full match was made on State/Province
State	1BZ-2325-PROVINCE
Home_State	1BZ-2325-PROVINCE
Mail_State	1BZ-2325-PROVINCE
Prefecture – JP	1BZ-2325-PROVINCE
Business Name	1BZ-2000-ORGANIZATION	Full match was made on Organization/Business Name
OrganizationName	1BZ-2000-ORGANIZATION	Full match was made on Organization/Business Name
Organization_name	1BZ-2000-ORGANIZATION	Full match was made on Organization/Business Name
Any country specific Business ID that is returned today (e.g. CNPJ, RFC)	1BZ-2525-BUSINESSID	Full match was made on Organization/Business Registry Number
Business Verification match	1BZ-2295-MATCHED_1+1	Full Match for business 1+1 verification

Data Source Types (DST)

Data Source Type	Abbreviation	Codes/Descriptions
Business Registry	BUS	A public or private register of organizations.
Court Records	CRT	Court registries.
Tax Registry	TAX	Government collated and issued business databases, mostly accessible through a single business identifier like TAX ID, DUNS or VAT numbers.
Regulatory Body	REG	Similar to Business Registries, public or private registers of organizations in the jurisdictions they operate under.
Commercial Directory	CDY	Online transactional data sources from sources, Domain data, CRM, Web scraping and other e-commerce site sources.

Match Type Messages

MT Field Name	1MT Message
SUBPREMISE	Full match was made on Sub Premise Descriptors provided in Address Lines
BUILDING	Full match was made on Building Descriptors provided in Address Lines
ADDRESS	Full match was made on address elements provided in Address Lines
THOROUGHFARE	Full match was made on Street/Thoroughfare
DISTRICT	Full match was made on District
LOCALITY	Full match was made on City/Locality
POSTALCODE	Full match was made on Postal Code/Zip Code
PROVINCE	Full match was made on State/Province
HOUSENUMBER	Full match was made on House Number
ORGANIZATION_NAME	Full match was made on Organization/Business Name
BUSINESSID	Full match was made on Organization/Business Registry Number
COUNTY	Full match was made on County

BZ Types

1BZ	Indicates a complete match was made with the data source from the input element.
2BZ	Indicates a non-match of the input element and the data source.
3BZ	Indicates a partial match was made with the data source from the input element.

Match Types

1MT	Element fully matched with the data source.
3MT	Element partially matched with the data source.
4MT	Element is not contained in the data source.

Business Data Enrichment (BDE) Messages

BDE messages provide information from matched data sources to allow you to confirm, or enrich, the data you have about a business entity. This information can be used to reduce the data input requirements you have on your users, or can be used to confirm and validate information supplied by a user.

The available data differs by the product-level chosen, which is confirmed in the below table.

BDEs are formatted as:
BDE-**-****-(enrichment type), where:

The table below explains the BDEs available and additional detail. To explain the API response information (noting in the table some items in red) you may expect to see something like: where:

BDE = business data enhancement message, as distinct from MT or BZ messages
** = is country code for the matched data, for example ‘NZ’ for New Zealand
**** = is the source of matched information, for example BUS1. This is presented so you can store in records for future audit purposes where the matched data is sourced from.
(enrichment type) the type of BDE being returned, e.g. ORGANIZATION_NAME
e.g. "BDE-NZ-BUS1-ORGANIZATION_NAME"

BDE Description	API Response	Value
Business ID	BDE--**-BUSINESSID	Where a match has been made on name and address values, allows business ID to be saved
Business Name	BDE--**-ORGANIZATION_NAME	Where a match has been made on business ID, or a partial business name match, allows business name to be saved
Business Address (multiple)	BDE---ADDRESS BDE--**-ADDRESSLINE1 BDE--**-THOROUGHFARE BDE--**-LOCALITY BDE--**-PROVINCE BDE--**-POSTALCODE BDE--***-COUNTRYCODE BDE--*-UNFORMATTED_ADDRESS	Where a match has been made on business ID, or a partial address match, allows business registered address details to be saved. Notes: 'Address' is formatted single line address (to Locality) Addressline1 and Thoroughfare are subsets of Address Locality otherwise known as suburb/town/city Province could otherwise be known as State or Administrative region Where a data source does not supply address information broken down into sub-address elements, the Unformatted Address BDE may be used
Company Type	BDE--**-COMPANY_TYPE	Type of business registered. Values are not standardized - that is, we pass through the type from the business registry. An example may be 'LLC', 'Sole Trader', etc
Company Status	BDE--**-COMPANY_STATUS	Status of business registered. Values are not standardized - that is, we pass through the status from the business registry. An example may be 'active', 'closed', 'insolvent', etc
Registration Date	BDE--**-REGISTRATION_DATE	When business was first registered within business registry. Values passed back in US date format (MM/DD/YYYY)

Note that where value is null from the business record, the BDE message will not be returned. For example, if a registry holds only locality and postcode information, not street address info, only the locality and postcode address information will return.

Important - unless you specifically request for these enhancements in your API request, the detail will not be provided. To enable it, pass the value 'businessenrich' in your options parameters.

Business Verification (BV) Default Match Rules

Reliability	Business Name Match	Business Address Match	Business ID Match
10	Match	Match	Any Value (Match / No Match)
	Match	Any Value (Match / No Match)	Match
	Any Value (Match / No Match)	Any Value (Match / No Match)	Match
20	Match	Partial Match	Any Value (Match / No Match)
30	All other combinations