Overview
The License Validation tool checks whether the producer or agency named on a tax form or license certification holds the license number printed on the document, and whether that license sits in the state where the business is being written. You can upload the PDF and let Turris read the fields for you, or type the NPN, license number, and risk state in by hand. Turris resolves the broker against your enterprise's member-agency NIPR records and tells you whether the printed license is on file, active, and in the right state.
What is License Validation?
License Validation answers two questions in a single pass: did the NPN (or license number) on the form resolve to a real broker inside your enterprise, and is the printed license number on file in your records for the state you care about.
Who uses it. Licensing managers, underwriting reviewers, and compliance staff at enterprise upstream entities who receive license tax certifications from member agencies and need to confirm the document before booking the business.
Validate a member-agency broker straight from a PDF without re-keying any fields
Type the NPN, license number, and risk state in manually when no PDF is available
See exactly which values Turris worked from and how each one resolved
Confirm a license is on file, active, and held in the state where the policy is written
Drill into every other license the same broker holds, with filters for status, state, and line of authority
Accessing License Validation
Open Left sidebar → Tools, then click the License Validation card in the tool grid. The breadcrumb at the top of the page reads Tools > License Validation. The page opens in its initial upload state with a single card and stays there until you submit a validation. Once a result loads, the upload card is replaced by the result view.
The upload card holds one form covering both input paths:
Element | Description |
File upload | Drop zone for the broker's PDF tax form or license certification. Drag a file in or click to open the picker. PDF only, 10 MB maximum. |
NPN | National Producer Number for the broker. Digits only. |
License Number | State license number printed on the form. |
Risk State | The state the policy is being written in, used to scope the license check. Searchable dropdown of every US territory in |
Validate | Submits whichever path is complete (file upload or manual entry). Stays disabled until one path is valid. |
The upload path and the manual path are mutually exclusive. Choosing a file disables every manual field, and filling any manual field disables the file picker. When the manual fields are in use, a hint reads Clear all manual fields to enable file upload. When a file is attached, a hint reads Click the uploaded file to replace or remove it. Remove it to enable manual input.
Validating From a PDF
When you'd do this. A member agency sent you a license tax certification or producer license PDF and you want to confirm the broker, license number, and risk state on the document without re-typing them.
Open Left sidebar → Tools → License Validation.
Drag a PDF into the upload area, or click the area to open the file picker. Only PDFs are accepted. A non-PDF file is rejected with
Only PDF files are accepted, and files over 10 MB are rejected by the server.Click Validate. The page swaps to the Validating form... loader with the subline
This usually takes a few seconds.While the loader runs, it rotates through the extraction and lookup steps so you can see what is happening:
Reading the certification PDF...Extracting NPN, license number, and risk state...Locating member agency in your enterprise...Validating license number against state records...
When the result loads, review the stacked result cards described in Reading the Result.
Tip: Click an uploaded file in the drop zone to replace or remove it. Removing the file re-enables the manual fields without resetting the page.
Validating Manually
When you'd do this. You do not have a PDF, the PDF failed to extract cleanly, or you want to spot-check a specific NPN and license number you already know.
Open Left sidebar → Tools → License Validation.
Fill the manual fields:
Field | Required | Description |
NPN | Yes, unless License Number is provided | National Producer Number for the broker. Digits only. Anything else is rejected with |
License Number | Yes, unless NPN is provided | State license number printed on the form. Example: |
Risk State | Optional but recommended | The state the policy is written in. Pick from the dropdown. Without it the license check is not scoped to a single state. |
Click Validate. The same Validating form... loader appears with the same four rotating messages regardless of which path you used.
When the result loads, the result cards render the same way as the PDF path. The Fields used for validation card shows whatever you typed in.
Note: At least one of NPN or License Number must be filled. Risk State on its own is not a valid identifier. When only a Risk State is selected, the Validate button stays disabled and a hint reads NPN or License Number is required to validate.
Reading the Result
A successful validation renders two stacked result cards under a recap card, plus a Validate another form button. A collapsible Other Licenses panel appears below the cards when the broker is found and has additional licenses on file.
Fields used for validation
The first card, headed Fields used for validation, recaps what Turris worked from. For a PDF submission these are the values the extractor pulled out of the document. For a manual submission these are the values you typed in. The card shows three values, NPN, License Number, and Risk State, in a monospaced font, and the NPN and License Number support one-click copy.
Each value carries a small status icon next to its label so you can see at a glance how it resolved:
Icon | Meaning |
Green check | The value resolved cleanly. For NPN this means the broker was found; for License Number and Risk State it means the license matched. |
Red cross | The value did not resolve. For NPN the broker was not found; for License Number and Risk State the license was unmatched. |
No icon | The field was blank in the source, so nothing was checked against it. |
The Risk State icon mirrors the license-match outcome rather than running a separate state check, so it turns green only when the license itself matched.
Entity Information
The second card, Entity Information, answers "who is this broker?" The header carries a status badge:
Color | Label | Meaning | What to do about it |
Green | Found | The NPN (or license number) resolved to a single broker inside your enterprise's member agencies. The card body lists Name, NPN, Entity Type ( | Move on to the License Validation card below. |
Red | Not Found | The identifier did not resolve to a broker in your member agencies, or more than one broker matched and Turris could not pick one. | If the body lists candidate brokers, copy the correct NPN and rerun the validation with that NPN. Otherwise read the explanatory message under the badge. |
When more than one broker matches a license number, the card body shows an explanatory message followed by a small candidate table with columns Name, NPN, and Entity Type. This is your cue to disambiguate by NPN.
License Validation (per state)
The third card answers "is this license real and current?" Its title is License Validation followed by the risk state name when one was supplied (for example, a Texas validation appends Texas to the title). The header carries a status badge:
Color | Label | Meaning | What to do about it |
Green | Matched | The license number was found on the broker's licenses (scoped to the risk state when one was given). The card body shows the matched row or rows in a table with License Number, State, Class, Lines of Authority, Issue Date, Expiry Date, Entity Type, and Status. | The printed license is on file. Confirm the Status reads Active and the Expiry Date is in the future. |
Red | Unmatched | The license number was not found, was not provided, or the broker could not be resolved. The card body shows an explanatory message naming the reason. | Open Other Licenses below to see what the broker actually holds and confirm whether they are licensed in the correct state. |
Other Licenses
When the broker is Found and holds licenses beyond the matched one, an expandable Other Licenses (n) panel appears below the cards, where n is the count. When the license check came back Unmatched with no matched rows, the panel renames itself to Licenses on file (n) to point you toward it as the next step.
Click the panel heading to expand it. The body shows a paginated table of every license the broker holds across every state, with a filter bar and search box above it. The table lists the same columns as the matched table: License Number, State, Class, Lines of Authority, Issue Date, Expiry Date, Entity Type, and Status.
Tip: Treat Other Licenses as the second step on every Unmatched result. The number printed on the form may be a typo, a stale number, or a number from a different state. The panel surfaces the broker's real licenses so you can confirm what they actually hold.
Filtering and Searching Other Licenses
The Other Licenses panel offers two dropdowns, one status badge group, and a free-text search box, all in a filter bar above the table.
Filter | Type | Purpose | Example use |
State | Multi-select dropdown | Limit the table to one or more states where the broker is licensed. A select-all control is available for quick scope changes. | Confirming the broker is licensed across the TX, LA, and OK belt. |
Line of Authority | Multi-select dropdown | Limit the table to one or more lines of authority across the broker's licenses. | Spot-checking that the broker carries |
Status | Badge toggle | Show only Active, only Inactive, or both. | Reviewing renewals: click Inactive to surface lapsed licenses only. |
The search box (in the filter bar, marked with a magnifying glass and the placeholder Search licenses…) matches as you type across the table's columns, including license number, state, class, line of authority, entity type, and status. Partial matches work, so typing Prop finds Property.
Status Indicators
The result cards use one consistent color scheme across the Fields used for validation, Entity Information, and License Validation cards.
Color | Where it appears | Meaning | What to do about it |
Green | Status icon on a field; Found badge; Matched badge; Active badge on a license row. | The field, the broker, or the license resolved cleanly. | No action needed. Confirm a license row's Expiry Date is still in the future before relying on it. |
Red | Status icon on a field; Not Found badge; Unmatched badge; Inactive badge on a license row. | The field, the broker, or the license did not resolve, or the license has lapsed. | Check the Fields used for validation card for a misread value, then expand Other Licenses to see what the broker actually holds. |
Primary (brand) | Entity Type badge inside the broker card, the candidate table, and the license tables. | Informational only. Labels the broker or license holder as Producer or Agency. | None. This badge is a label, not a status. |
Frequently Asked Questions
What kinds of documents can I upload? PDF files only, up to 10 MB. The extractor is tuned for tax forms and license certifications that print an NPN, a license number, and a state code. Other formats such as JPG, PNG, or DOCX are rejected before submission.
Why was the broker shown as Not Found when I know they exist? Not Found means the identifier did not resolve to a broker inside your enterprise's member-agency NIPR data. Common causes: the extractor misread the NPN (check the Fields used for validation card first), the broker is not linked to one of your member agencies, or the broker uses a different NPN than the one printed on the form.
Why does an Unmatched result happen when the broker is Found? The license number on the form did not appear on the broker's licenses for the state you scoped to. The broker exists, but either the license number is wrong, the state is wrong, or the broker has never held that specific license. Expand Other Licenses to see what they actually hold.
Can I validate without selecting a Risk State? Yes. Without a risk state, Turris matches the license number against the broker's licenses in every state, so a license held in any state counts as a match. Adding a risk state narrows the check to that one state, which is what you want when you need to confirm the broker is licensed specifically where the policy is being written.
Can I look up every license a broker holds without checking a specific number? Yes. Supply the NPN and a risk state but leave the license number blank, and the License Validation card returns every license the broker holds in that state as Matched. Supply only the NPN and you will see the broker resolve in Entity Information while Other Licenses lists everything they hold.
Can I validate another form after seeing a result? Yes. Click Validate another form below the result cards. The page resets to the upload state and clears the prior result so you can submit a new file or new manual entry.
What if the PDF does not include all three fields? Whatever the extractor finds appears in Fields used for validation. If only the NPN was extracted, the entity card still resolves the broker, but the License Validation card returns Unmatched with Unable to verify the license with the provided parameters. because there is no license number to check. Use Other Licenses to review what the broker holds.
Best Practices
Use the PDF path when you have one. The extractor reads the printed fields directly and removes transcription errors. The manual path is the right fallback when no PDF is available or the extractor misreads a field.
Always read Fields used for validation first. A wrong NPN or license number at the top of the page poisons every downstream result. The status icons on the field labels tell you at a glance whether each value resolved.
Set a Risk State when you need a state-specific answer. Leaving it blank matches the license number across every state, which is fine for a "do they hold this at all" check but not for confirming they are licensed where the policy is written.
Treat Other Licenses as the second step on every Unmatched result. An Unmatched verdict only means the specific number was not found in the scoped state. The broker may still be properly licensed elsewhere, and Other Licenses is where you confirm that.
Use the candidate table to disambiguate. When Entity Information is Not Found with multiple candidates, copy the correct NPN out of the table and run a second validation with that NPN in the manual fields rather than chasing the original form.
Need Help?
If you have questions about License Validation or encounter any issues, contact our support team at support@turris.com.