Company Search through API

1. Set up a workflow

Access the Trust Platform and then the Workflow Builder. For the moment, we only have one KYB flow template available. Select the pre-configured template and proceed with creating 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 Global 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 > Global API > 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 workflow step.

Using the Global 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 > Global API > Orchestrations.

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

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