API Reference

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, which can be either the commercial or legal 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 / domain associated with the company is one of the best main identifiers for a company. This can be passed either as an URL (https://veridion.com/) or as a root domain (veridion.com).

  • Registry ID: Local Unique ID as provided by the local registry where this legal entity is incorporated.

  • 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.

📘

Receive registry information

Registry information is returned in the response whenever available and the provided input can help validate the presence of a company in a given jurisdiction.

Passing in the company name as input, together with the company address and optionally, the unique registry ID will enable validation of registry information.


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 result

The API returns a single, best match result, leveraging Veridion's matching algorithm. Check this section if you want to know more: How the matching works.

📘

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 Complex Search API section.