Company Search through API

1. Set up a query template

Access the Trust Platform and then Query Templates. Select the Query Template you want and proceed to create the workflow.

2. Get company ID

The global context is dynamic and different countries use different ways of identifying companies. For this reason, you need to look up the identifier of the company you want to submit to workflow.

Using the Core API and the Services resource, make a request asking for the kybCompanySearch service and providing the information of the known company. You can find more details on how to make this request visiting API Reference > Core API > Available Resources > Services.

In response, two identifiers are expected: creditReportId and businessIdentityId.

Note: not all identifiers will always be available. There are cases where only one or no bureau is compatible with the source information.

3. Start a transaction

Once you have at least one identifier, you can start a transaction in the flow configured in the 1. Set up a query template step.

Using the Core API and the Orchestrations resource, make a request to create a transaction. In request’s body, enter at least one of the identifiers obtained in the 2. Get company ID step. You can find more details on how to make this request visiting API Reference > Core API > Transaction Details.

Note: keep the same attribute name.

If successful, the ID of the newly created transaction will be available in the body of the response, in an attribute named id.

4. Check results

Finally, once you have the transaction ID, you can retrieve the information that was requested according to the Workflow configuration created in the 1. Set up a query template step.

Note: you must wait for the transaction to be processed before the data is fully available.

Alternative: wait for a webhook update and only get the info when the transaction has an update. See more details here.