This endpoint allows you to submit a principal (individual) for detailed background verification.
Current Capabilities: This endpoint currently supports the following data sources:
Bankruptcies: Individual bankruptcy records
Liens: Tax and other lien records
Judgements: Civil judgment records
Watchlists: Sanctions and watchlist screening
Healthcare Professional Verification: Medical license verification for healthcare professionals
Home Services License Verification: Professional license verification for contractors and home service professionals
Principal Categories:
healthcare: For medical professionals (doctors, nurses, etc.). License verification is supported.
homeServices: For home service professionals (contractors, etc.). License verification is supported.
other: For all other principals. License verification is not supported for this category.
License Verification: License verification is now fully supported for healthcare and homeServices categories:
Healthcare Professionals:
Set enhanced_license_search to true to search our database for additional licenses beyond those provided
If enhanced_license_search is true but no licenses are provided, the system will attempt to find and verify all licenses for the matched healthcare professional
If enhanced_license_search is true AND specific licenses are provided, the system will verify BOTH the provided licenses AND all licenses found in our database (duplicates are automatically removed)
If enhanced_license_search is false AND specific licenses are provided, the system will verify ONLY the provided licenses (no NPI database lookup)
Each license requires licensee_state (2-character state code) and licensee_id (license number)
For healthcare professionals, you may also provide an npi_id to help with matching
Home Services Professionals:
The enhanced_license_search field is ignored for homeServices professionals
License verification is triggered by the presence of licenses in the licenses array
Each license requires licensee_state (2-character state code) and licensee_id (license number)
Required Fields:
first_name, last_name, callback_url, merchant_id, principal_category
run_license_verification: Boolean - Whether to run license verification searches
run_litigation: Boolean - Whether to run litigation searches
run_bljs: Boolean - Whether to run bankruptcy, lien, and judgment searches
run_adverse_media: Boolean - Whether to run adverse media searches
Optional Fields for License Verification:
enhanced_license_search: Boolean indicating whether to search NPI database for additional licenses (healthcare only)
licenses: Array of license objects with licensee_state and licensee_id
Response: This endpoint returns a request ID that can be used to check the status or retrieve results of the principal verification process. The actual detailed report will be sent to the provided callback URL when processing is complete.
Callback Response: When processing is complete, the callback URL will receive a POST request with the same response format as the Seller Report endpoint. This includes all the detailed background verification results for the principal.
Principals Structure Updates: The principals field in the response has been updated for this new process. principals is a list of unique principals associated with the merchant. Each unique principal record contains a source_principals key, which is a list of source-level principal records.
Each item in the source_principals list represents a principal found from a specific data source. If a principal was discovered through a bankruptcy, lien, or judgment (BLJ) search, the corresponding blj_data field will contain all the necessary information about that principal from that source.
Processing Time: Typical processing time is 5-10 minutes depending on the data sources being searched.
