How the Match & Enrich API works

The user passes a company’s details as input and receives an enriched company profile as output.

The API requires just one company name as input — either the commercial/trading or registered name of the business — along with the country as the address where the company is registered, headquartered or operates.

Additional accepted inputs

The API allows passing in additional information in the input, such as:

• Company address: The API will work with any level of specificity and format, for example:

  • Country only ( full name or code ): United States or US or USA
  • Partial address: Amsterdam, Netherlands or abbreviated TX, L4P2E1, US
  • Full Address: 430 THE QUEENSWAY S GEORGINA ON L4P2E1 CA

• Website: The website associated with the company is one of the strongest identifiers available. This can be passed either as an URL (https://veridion.com/) or as a root domain (veridion.com).

• Registry ID: A unique identifier from an official registry where the legal entity is incorporated — including local registration numbers, VAT numbers, and LEI codes.

• Phone number: A phone number associated with the company is a great way to prevent matching to a different entity named the same.

👍

Tip

Although the API can work with limited input, providing additional information can be extremely helpful:

• To enable advanced matching: When extra information is supplied, the matching process is designed to handle some inaccuracy in the input.
  As a result, even in cases of typographical errors or minor differences in the input company name, the API can still make a match by using additional details, such as the website or phone number, to identify the appropriate company.
  
• To avoid false positive matches: Company names, especially commercial ones, tend to be very common. Having a more detailed company address or the company's website can help bring back better matches.

Input normalization

Before running the matching algorithm, the API applies validation and normalization rules on the provided input:

• Company address: Input address is broken down into individual parts (e.g. Country Code, Country, City etc.) and normalized to common namings or taxonomies ( e.g. USA country code becomes US ). This allows the API to work with any level of address specificity and format.

• Website: Validated and normalized to domain level format. This allows the website to be passed either as a root domain or full URL.

• Registry ID: Validated and normalized to the country specific format, whenever possible. Can be passed in various formats, e.g. with or without dashes or spaces.

• Phone number: Validated and normalized to prefixed phone number format. This allows the phone number to be passed in various formats, e.g. with or without country/region prefixes.

📘

Matching vs. Searching

Please note that the Match & Enrich API is not designed for search purposes. If your use-case involves discovering companies rather than matching records, please check the Search API section.