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-**-****-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:
|
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 |
Any Value |
Match |
|
Any Value |
Any Value |
Match |
|
20 |
Match |
Partial Match |
Any Value |
30 |
All other combinations |