Retrieving an enriched profile

post https://data.veridion.com/match/v4/companies

The Match & Enrich API allows you to retrieve an enriched company profile by passing the company name and location as input.

Run in Postman


Required fields

The request payload must include the following elements:

  • Values for either legal_names or commercial_names arrays .
  • At least one of the following fields: address_txt, website, or phone_number.

📘

Single company request

Please note that one request must include information about a single company.

The legal_names and commercial_names fields are available as arrays to enable passing in name variations or historical names of the same company.

Enable Advanced Matching

While the API can operate with limited input, providing additional information will help avoid false positive matches.

Company names, especially commercial ones, are often very common. Therefore, a more comprehensive company address, along with the phone number of the business or the website of the company, can be extremely helpful in enhancing the accuracy of the results.

👍

Adding company details

When extra information is supplied (e.g., a more detailed company address, website, or phone number), 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 phone number, to identify the appropriate company.

For additional information on matching, please refer to the How the matching works section.


Successful responses

When the request is successful, the API returns a standard 200 OK HTTP status, together with the JSON representation of the enriched company profile.

📖

Response datapoints

For a comprehensive list of all data points returned and additional information, please refer to the Response Fields and Types page.

Error responses

If the request is unsuccessful, the API will return one of the below HTTP status responses:

  • 400 Bad Request, if the input lacks any of the required fields .
  • 202 Accepted, if the requested entity does not correspond to any entry in the Veridion database.
  • other standard HTTP error responses, detailed in the Response codes section.

Any error response follows a specific structure. Please see the Error response format section for more details.


Language