Skip to main content
You can manage companies either through the iDenfy dashboard or via the API.

​
Viewing Companies

To view all submitted companies (or forms), use the dashboard or the API.
For the List Companies endpoint (shows a list of all company reviews, including their status and details), see the API Reference tab for kybCompaniesList.

​
Reviewing a Company

To mark a company review as complete, change its status to COMPLETED using the API.
For the Change Status endpoint (marks a company review as completed), see the API Reference tab for kybCompaniesChangeStatusCreate.
You can also receive a webhook notification when a company is reviewed by enabling the COMPANY_REVIEW notification in your Notification Settings).

​
Retrieve all company information

For the Retrieve complete information about company endpoint, see the API Reference tab for kybCompaniesRetrieve.

​
Deleting a Company

Companies can be removed from the dashboard or via the API.
For the Delete Company endpoint (removes a company and its session from the system), see the API Reference tab for kybCompaniesDestroy.

​
Request Update

You can ask your client to update submitted data using the Request More Information (RI) functionality.

​
Step 1: Request more information

Initiate RI via dashboard). To track and handle these updates, set up the COMPANY INFO REQUEST webhook event.

​
Step 2: Checking the Flow

The data requested during RI may differ from the original form. To determine what fields are needed, retrieve the flow information.
For the Retrieve Flow endpoint (shows the fields currently required during RI), see the API Reference tab for kybInfoRetrieve.

​
Step 3: Update

Any updates can be made using the same endpoints used in the initial Business verification flow, described in:
To check if a questionnaire is required, use the list endpoint and fill in the first item, especially if multiple are listed. See kybFormsQuestionnairesList in the API Reference.