How can I retrieve business verification results and user inputs via API?

Last updated: October 21, 2025

Context

When running business verifications through multiple templates, customers need to track verification completion status, retrieve user inputs, and check verification results through API endpoints.

Answer

There are several API endpoints available to retrieve business verification information:

  1. To receive automatic notifications (Callback):

  • Configure callback_url and event_callback_url at the template level through the Dashboard under View Templates > {TemplateID} > Settings

  • Alternatively, include the callback_url parameter in your API request (this takes precedence over template settings)

Callback notifications will include:

  • business_profile_id - The ID associated with the business profile

  • business_profile_result - Final decision (APPROVED, DECLINED, REVIEW)

  • business_info - Extracted business information

  • client_reference_id - Your associated verification request ID

You can also configure events_callback_url to receive notifications about intermediate events during the verification process. These events will be visible under the Activity section.

Here's an entire list of events that are fired.

  1. To fetch verification status via API:

  • Use GET /verify/get-business-profile/{business_profile_id} to fetch details of the entire business profile