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:
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.
To fetch verification status via API:
Use GET /verify/get-business-profile/{business_profile_id} to fetch details of the entire business profile