Overview
NPN Lookup is where you resolve a batch of National Producer Numbers against NIPR's PDB in one session, so you can confirm who each NPN belongs to, what type of entity it is, and where it holds a resident license without looking producers up one at a time.
What is NPN Lookup?
NPN Lookup is a self-service batch verifier. You hand it a file or a typed list of NPNs, and it returns the name, entity type, resident licensing footprint, and the FEIN (for firms) or date of birth (for individuals) for each one, in a table you can export to CSV.
Who uses it. Licensing managers, compliance analysts, and operations leads at carriers, MGAs, and other enterprise upstream organizations use NPN Lookup when they need to triage a list of producers quickly. Typical jobs to be done: vetting a new producer roster before onboarding, validating a downstream agency's submitted producer list, or sanity-checking NPNs pulled from a renewal spreadsheet.
NPN Lookup lets you:
Submit up to 500 NPNs per session, either by uploading a file or typing them in.
Have Turris auto-extract NPNs from CSV, TXT, Excel, or PDF files, so you do not have to clean the source first.
Review and edit the extracted list before running the lookup against NIPR.
Watch progress in real time as each NPN is resolved.
Filter the result set by outcome (Individuals, Firms, Not Found, Errors) by clicking the matching summary card.
Download the full result set as CSV for archival or downstream review.
Accessing NPN Lookup
Open Left sidebar → Tools. The Tools hub loads with a grid of tool cards.
Click the NPN Lookup card. The page opens to the input screen with the NPN Lookup heading.
The breadcrumb at the top of the page reads Tools → NPN Lookup. Click Tools in the breadcrumb at any time to return to the tool hub.
What's visible on the page. The page shows different panels depending on which step of the flow you are in:
Element | When it shows | Description |
NPN Lookup input card | Idle state (before you start) and after a failure | Contains the Upload File and Enter NPNs Manually tabs. The subtitle reads "Look up producer information from NIPR by NPN. Supports up to 500 NPNs per session." |
Review Extracted NPNs card | After a file extraction completes | Shows every NPN found in the uploaded file as a removable tag, with a count and any cap warning. |
Progress card | While a file is being extracted or the lookup is running | A spinning indicator, the heading Looking up NPNs..., an "N of N processed" counter, and a horizontal progress bar with a percentage. |
Summary card row | Once results begin arriving | Four clickable counters (Individuals, Firms, Not Found, Errors) above the results table. |
Results table | Once results begin arriving | Sortable table with the columns Name, ID, Type, Resident States, and Additional Info. |
Export CSV button | Once results begin arriving | Sits at the top of the results area, above the summary cards. |
Red error banner | After a failure | A red strip with an alert icon at the top of the page describing why the job failed. |
Uploading a File of NPNs
When you'd do this. You already have the NPNs in a spreadsheet, exported list, or PDF (for example a producer roster from a downstream agency or a renewal report) and you do not want to type them in by hand.
Open Left sidebar → Tools → NPN Lookup. The Upload File tab is selected by default.
Drag a file into the upload area, or click the area to open a file picker and choose a file from your computer.
Click Upload and Extract NPNs. Turris reads the file and pulls every value that matches an NPN format.
A brief progress display appears while the file is processed, then the page transitions to the Review Extracted NPNs screen so you can inspect what was extracted before running the lookup.
The upload area accepts the following:
Field | Required | Description |
File | Yes | A single file containing the NPNs you want to look up. Accepted extensions: |
Note: If the file extension is not in the accepted list, the panel shows "Unsupported file type" with the full list of accepted extensions and does not start extraction. If the file is over 10 MB, it shows "File size exceeds the 10 MB limit."
Entering NPNs Manually
When you'd do this. You have a small handful of NPNs (a dozen or fewer is typical) you want to verify on the spot, for example NPNs pasted from an email, taken from a phone call with a producer, or copied from a single line in a contract.
Open Left sidebar → Tools → NPN Lookup.
Click the Enter NPNs Manually tab.
Type or paste an NPN into the input box. Press Space, comma, or Enter to commit it as a tag. Repeat for each NPN. Each tag shows the NPN and an X icon to remove it.
Click Lookup N NPNs (where N is the count of tags you have added). The page skips the review step and goes straight to the progress card.
Field | Required | Description |
NPNs | Yes | One or more NPNs entered as tags. Each NPN must be digits only (1 to 10 characters). Duplicates and non-numeric values are ignored when committed. Example: |
Tip: You can paste a comma- or space-separated list straight into the input box, and Turris splits it into individual tags automatically. Pasting 12345, 67890, 11111 adds three tags in one go.
Reviewing Extracted NPNs
When you'd do this. Only file uploads go through this step. Use it to inspect what Turris pulled out of your file before spending the time on the lookup itself, because extraction reads anything that looks like an NPN, including stray numbers in unrelated columns.
After extraction finishes, the Review Extracted NPNs card appears. It shows the count ("N NPNs found") and every NPN as a removable tag.
Adjust the list as needed:
Remove an NPN. Click the X on the tag.
Add more NPNs. Click into the tag area and type, then press Space, comma, or Enter to commit each one. The hint reads "Remove tags or type to add more NPNs."
Click Look Up N NPNs to start the lookup against NIPR, or click Cancel to discard the extracted list and return to the input screen.
Note: If the extracted list exceeds 500 NPNs, the count shows "(capped at 500)" in amber text and only the first 500 are processed. Trim the list yourself if you need control over which 500 are run.
Tracking Progress
When you'd do this. As soon as you click Look Up N NPNs or Lookup N NPNs, this panel takes over the page. Use it to confirm the job is moving and to estimate how long it will take.
The progress card shows:
A spinning loader icon next to the heading Looking up NPNs....
A counter line reading N of N processed, where the first N is the count completed so far and the second is the total submitted.
A horizontal progress bar with a percentage to its right.
Results begin appearing in the table below the progress card as soon as the first batch returns from NIPR, so you do not need to wait for the whole batch to finish before scanning what is already in.
Tip: Lookup speed depends on NIPR response time. A session stays active for 30 minutes; if a job has not finished in that window the session expires and you will need to restart.
Working with Results
Once results begin arriving, two areas appear: the summary card row and the results table.
Summary cards. Four cards sit above the table, each showing a count for one outcome bucket. Clicking a card filters the table to that outcome; clicking it again removes the filter. Activating all four cards is treated the same as no filter (the page shows everything).
Card | What it counts |
Individuals | NPNs that resolved to an individual producer in NIPR. |
Firms | NPNs that resolved to a firm or agency in NIPR. |
Not Found | NPNs that NIPR returned no record for. |
Errors | NPNs that failed to look up because of a NIPR-side error, a timeout, or a transient network issue. |
Results table. Each row is one NPN. The columns are:
Column | Description |
Name | The producer's full name or the firm's legal name. Shows a dash when the NPN was not found. Sortable and searchable. |
ID | The NPN. For firms, the FEIN is also shown beneath the NPN. Matches partial digits in the search box. |
Type | A color-coded badge: Individual, Firm, Not Found, or Error. Sortable. |
Resident States | The states where the entity holds a resident license, shown as a state circle next to each state name. The first four appear inline; if there are more, click the +N chip to open a popover with the rest. |
Additional Info | For individuals, the Date of birth when NIPR provides it, with a copy-to-clipboard icon. Shows a dash for firms and unresolved NPNs. |
Pagination appears automatically once the result set is more than 10 rows. If a filter leaves no matching rows, the table area reads "No results yet."
Exporting Results
When you'd do this. You want to archive the lookup, share it with a teammate, or feed it into another tool such as a spreadsheet, your agency management system, or a downstream report. Results live only for the duration of the session, so export before you navigate away if you need a copy.
Click the Export CSV button (it carries a download icon and sits at the top of the results area).
A CSV file downloads through your browser.
The export always contains the full result set. Applying a summary-card filter does not narrow the CSV.
Starting a New Lookup
When you'd do this. You have finished reviewing one batch and want to run another against a different list of NPNs.
Scroll to the bottom of the results.
Click New Lookup. The page clears the current results, summary cards, and any active filters, and returns to the input screen.
Note: New Lookup discards the in-memory results. If you have not exported the CSV yet, do so before clicking it.
Filtering and Searching
Filter | Type | Purpose | Example use |
Individuals card | Toggle (click to filter) | Show only rows that resolved to individual producers. | You are triaging a roster and want to focus on natural persons first. |
Firms card | Toggle (click to filter) | Show only rows that resolved to firms or agencies. | You are confirming the agency entities in a mixed roster. |
Not Found card | Toggle (click to filter) | Show only NPNs that NIPR returned no record for. | You want to compile the list of bad NPNs to send back to the source for correction. |
Errors card | Toggle (click to filter) | Show only NPNs that errored during lookup. | You want to retry just the failures without re-processing successes. |
Click a card again to remove its filter. Selecting all four cards is the same as selecting none.
The results table also has a search box that matches against the Name (typing part of a name finds it) and the ID (typing part of an NPN or FEIN finds it). Sort the table by clicking the Name or Type column headers.
Status Elements
The Type column uses a color-coded badge so outcomes are easy to scan, and the summary cards above the table use the same colors. Job-level failures appear as a red banner at the top of the page.
Color | Label | Meaning | What to do about it |
Blue badge | Individual | NIPR returned an individual producer record for this NPN. | Nothing. This is the expected outcome for a producer NPN. Review the name and resident states to confirm it is the right person. |
Purple badge | Firm | NIPR returned a firm or agency record for this NPN. | Nothing. This is the expected outcome for a firm NPN. Confirm the FEIN matches your records if you have one. |
Grey badge | Not Found | NIPR has no record for this NPN. | Treat the NPN as suspect. Check for a typo in your source data, confirm the producer is still active, or ask the source for the corrected value. |
Red badge | Error | The lookup itself failed, typically because of a NIPR-side error, a timeout, or a transient network issue. | Re-run just the errored NPNs in a new manual-entry session. If they keep erroring, wait a few minutes and try again, because NIPR can be temporarily unavailable. |
Red banner at the top of the page | Job-level failure | The whole job failed (extraction or lookup) before completing. The banner shows the error message and the input screen is restored. | Read the banner message. An extraction issue means the file could not be parsed (try a cleaner export); a lookup issue means a NIPR or network problem (retry the batch). |
Frequently Asked Questions
How many NPNs can I look up at once? Each session supports up to 500 NPNs. If your file contains more, only the first 500 are processed after the review step.
What file types are supported for upload? CSV (.csv), text (.txt), Excel (.xls, .xlsx), and PDF (.pdf). The maximum file size is 10 MB.
How does Turris extract NPNs from my file? Turris scans the file for numeric sequences that match the NPN format. For CSVs and spreadsheets it inspects every cell; for PDFs it reads the text content. You can review and edit the extracted list before running the lookup.
What data does NPN Lookup return? For each NPN: the producer or firm name, the entity type (Individual or Firm), the FEIN for firms, the resident license states, and the date of birth for individuals when NIPR provides it.
Why are some of my NPNs marked Not Found? A Not Found result means NIPR returned no record for that NPN. The most common causes are a typo in the source data, a producer whose record is no longer active in PDB, or a number that was never issued.
Why are some NPNs marked Error? Error means the lookup itself failed for that NPN, typically because of a NIPR-side error, a timeout, or a transient network issue. You can re-run errored NPNs in a new session.
Are results saved between sessions? No. NPN Lookup is a single-session tool. Results are kept for 30 minutes in the active job and are not stored against any agent, agency, or policy record in Turris. Export to CSV if you need to keep the data.
Can I export the results? Yes. The Export CSV button above the results downloads every result row. Filters applied with the summary cards do not narrow the CSV; the export always contains the complete result set.
Does NPN Lookup change anything in my Turris organization? No. NPN Lookup is read-only. It queries NIPR and shows the response. It does not create or modify any agents, agencies, licenses, or appointments in your enterprise.
Can I look up an NPN from a US territory like Puerto Rico or Guam? Yes. Resident states in the results include the US states and territories that NIPR returns (for example, PR, GU, VI). If the producer holds a resident license in a territory, it appears in the Resident States column.
Best Practices
Clean the source list before uploading. Remove header rows, duplicates, and obviously malformed numbers from your file. The extractor is permissive on purpose, so anything that looks like an NPN gets pulled in, including unrelated numeric columns.
Always review extracted NPNs before clicking Look Up. The review step is your last chance to catch noise such as zip codes, policy numbers, or phone numbers that the extractor mistook for NPNs.
Export immediately after each batch. Results live for the duration of the session only. Export the CSV before navigating away, closing the tab, or starting a new lookup.
Use the summary cards to triage failures. Click Errors to isolate failed lookups, copy the NPNs out, and retry them in a fresh manual-entry session, so you do not re-process the successes.
Split large lists into batches of 500 yourself. When you have more than 500 NPNs to verify, divide the source into deliberate batches in advance so you control which NPNs land in each session, rather than letting Turris cap silently at 500.
Treat Not Found as a data-quality signal, not a producer status. A Not Found outcome usually means the NPN itself is wrong. Go back to whoever provided the list and ask for the corrected NPN before assuming the producer is inactive.
Need Help?
If you have questions about NPN Lookup or encounter any issues, contact our support team at support@turris.com.