License Verification

When creating an inquiry, you can verify licenses in two ways:

1. Explicit license verification

Include one or more license records in the request body. Each submitted license must include:

• license_name

• license_id

• license_state

• license_category

You are billed for every license you explicitly include in the request.

2. NPI-based license discovery

For healthcare licensing, Verdata offers a License Discovery process. This process will check the submitted License inputs against the NPI database and retrieve available licenses for verification.

To enable NPI License Discovery, you must use the searchNpi param on a principal.

Verdata will verify one license per principal when searchNPI is enabled. If multiple licenses are discovered for the submitted healthcare professional, Verdata will default to verifying the license that exists for the state submitted. The other discovered licenses will return unverified. You can choose to verify each additional license later by submitting them through the add-license flow on the inquiry. The API supports adding licenses after inquiry creation through

POST /v1/inquiries/{inquiry_id}/licenses.

Users are billed per verification submitted. Licenses discovered that remain Unverified will not incur charges. Important usage guidance Use searchNpi only for healthcare professionals.

• principalType describes the person’s relationship to the business; it is not the control that determines NPI discovery behavior.

• Professional licensing is a billable verification source and must be enabled for your organization before it will run.

Billing summary You are billed for:

• every license explicitly included in the request

• the first license discovered through NPI and verified

You are not automatically billed for additional discovered licenses unless you later request verification for them. The API’s add-license endpoint supports that later verification workflow.