Resolution POST

POST
/v1/resolution

The resolution endpoints allow users to search for matching entities against a provided list of attributes. The endpoint is similar to the search endpoint, except it’s tuned to only return the best match so the client doesn’t need to do as much or any post-processing work to filter down results.

Query parameters

limitintegerOptional

A limit on the number of objects to be returned with a range between 1 and 10 inclusive. Defaults to 10.

offsetintegerOptional

Number of results to skip before returning response. Defaults to 0.

Request

This endpoint expects an object.
namelist of stringsOptional

Entity name

identifierenumOptional

Entity identifier. Can be from either the Identifier Type or Weak Identifier Type enums.

addresslist of stringsOptional

Entity address

citystringOptional

Entity city that contains the provided city name.

statestringOptional

Entity state that contains the provided state name.

countrylist of enumsOptional

Entity country - must be ISO (3166) Trigram i.e., USA. See complete list here

date_of_birthlist of stringsOptional

Entity date of birth

contactlist of stringsOptional

Entity contact

typelist of enumsOptional

Entity type. If multiple values are passed for any field, the endpoint will match entities with ANY of the values.

profileenumOptional
Allowed values: corporatesupplierssearch

Specifies the search algorithm to use. corporate (default) is optimized for accurate entity attribute matching, ideal for business verification. suppliers is tailored for matching entities with trade data, suitable for supply chain use cases. search mimics /search/entity behavior, best for name-only matches.

name_min_percentageintegerOptional

Adding this param enables an alternative matching logic. It will set a minimum percentage of tokens needed to match with user input to be considered a “hit”. Accepts integers from 0 to 100 inclusive.

name_min_tokensintegerOptional

Adding this param enables an alternative matching logic. It sets the minimum number of matching tokens the resolved hits need to have in common with the user input to be considered a “hit”. Accepts non-negative integers.

minimum_score_thresholdintegerOptional

Specifies the minimum score required to pass, which controls the strictness of the matching threshold. The default value is 77, and tuned for general use-case accuracy. Increase the value for stricter matching, reduce to loosen.

search_fallbackbooleanOptional

Enables a name search fallback when either the corporate or supplier profiles fails to find a match. When invoked, the fallback will make a call similar to /search/entity on name only. By default set to false.

cutoff_thresholdintegerOptional

Specifies the window of similar results returned in the match group. Increase for fewer multiple matches, decrease to open the aperture and allow for more matches. Default is .8

candidate_pool_sizeintegerOptional

Specifies the maximum number of entity candidates considered during search. Default is 50. Higher values increase match pool size but also increase latency.

skip_post_processbooleanOptional

Bypasses the post-processing setps and re-ranking. Useful for debugging. By default set to false, set to true to enable.

Response

This endpoint returns an object.
fieldsobject
datalist of objects