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.

​
Re-Run KYB Automation

You can programmatically trigger a KYB automation re-run for a specific company without opening the dashboard.
For the Re-run Automation endpoint (POST /kyb/companies/{id}/automation/), see the API Reference tab for kybCompaniesAutomationCreate.
A finance check is performed before the automation task is queued. On success, the endpoint returns a 202 status code confirming the automation task has been scheduled. If the automation cannot be started, an error response is returned with a reason.

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