Skip to main content

NPN Lookup

Written by Sven Gerlach

Overview

NPN Lookup is where you resolve a batch of National Producer Numbers against NIPR in one pass, so you can confirm who each NPN belongs to, whether it's an individual or a firm, and where the entity holds a resident license, without checking each number by hand.


What is NPN Lookup?

NPN Lookup takes a list of NPNs, queries NIPR's Producer Database in the background, and streams back a consolidated, filterable, exportable result set on the same screen.

Who uses it. Licensing coordinators, compliance analysts, and operations staff at agencies and TPAs reach for this when they have a list of producer numbers from a spreadsheet, a carrier file, or an onboarding application and need to verify who those producers are before onboarding them, paying commissions, or requesting appointments.

With NPN Lookup you can:

  • Verify up to 500 NPNs in a single session without creating a job, importing the numbers into your roster, or contacting support

  • Pull NPNs straight out of a CSV, TXT, Excel, or PDF file so you don't have to re-key them

  • Review and trim the extracted list before spending an NIPR call on it

  • Watch a live progress counter as results stream into the table

  • Triage the outcomes by clicking the Individuals, Firms, Not Found, and Errors cards to focus on one category at a time

  • Export the full result set to CSV so the data survives after the session ends


Accessing NPN Lookup

Left sidebar → Tools → NPN Lookup. The page opens directly to the input screen.

What's visible on the page:

Element

Description

NPN Lookup heading

Title of the input panel. The subtitle reads "Look up producer information from NIPR by NPN. Supports up to 500 NPNs per session."

Upload File tab

The default tab. A drag-and-drop area for a single source file. Accepted formats: CSV, TXT, Excel, PDF.

Enter NPNs Manually tab

The alternative input. A tag field where you type or paste NPNs.

Export CSV button

Appears in the top-right of the page only after a lookup completes.

Once a lookup finishes, the input panel is replaced by four summary cards and the results table. Click New Lookup below the results to return to this input screen.


Running a Lookup From a File

When you'd do this. A carrier or MGA sent you a spreadsheet of producers they want appointed, or you exported a list from another system, and you want to verify each NPN before adding the producers to your roster.

  1. Open Left sidebar → Tools → NPN Lookup.

  2. Stay on the default Upload File tab.

  3. Drag your file into the upload area, or click it to browse. The helper text below the upload area reads "Supports CSV, TXT, Excel, and PDF files."

  4. Once a file is selected, click Upload and Extract NPNs. Turris scans the file for anything that matches an NPN format.

  5. The page advances to the Review Extracted NPNs panel (see the next section).

Field

Required

Description

File

Yes

A single file containing NPNs. Accepted extensions: .csv, .txt, .xlsx, .xls, .pdf. Maximum size: 10 MB.

Note: A file with an unsupported extension is rejected before extraction starts, with an inline error above the upload area: "Unsupported file type. Accepted: .csv, .xlsx, .xls, .pdf, .txt". A file over the size limit shows "File size exceeds the 10 MB limit."

Tip: For CSVs and spreadsheets, extraction inspects every cell; for PDFs, it reads the text content. You get a chance to remove false positives in the review step, so don't worry if your source file has extra columns or stray numbers.


Reviewing and Editing the Extracted NPNs

When you'd do this. Immediately after a file finishes extracting. The Review Extracted NPNs panel shows a count ("123 NPNs found") and every extracted NPN as a removable tag. This review step appears only for file uploads; manual entry starts the lookup directly.

From this panel you can:

  • Remove an NPN: click the X icon on its tag.

  • Add more NPNs: type into the field and press Space, comma, or Enter to commit each one as a tag. Backspace on an empty field removes the last tag.

  • Cancel: discard the extracted list and return to the input screen.

  • Look Up N NPNs: start the lookup against NIPR. The button label updates to reflect the current count and is disabled when the list is empty.

Tip: If the list exceeds 500, the panel shows "(capped at 500)" next to the count and only the first 500 are processed. Trim the list manually if you want to control which NPNs are kept.


Running a Lookup From a Manual List

When you'd do this. You have a short list of producer numbers, pasted from an email, jotted down from a call, or a handful you want to spot-check, and skipping the file step is faster than building a spreadsheet.

  1. Open Left sidebar → Tools → NPN Lookup.

  2. Click the Enter NPNs Manually tab.

  3. Type each NPN into the field and press Space, comma, or Enter to add it as a tag. Backspace on an empty field removes the last tag.

  4. Click Lookup N NPNs. The lookup starts immediately. There is no separate review step for manual entry.

Field

Required

Description

NPNs

Yes

One or more numeric NPNs (digits only). Non-numeric values are ignored, and duplicates within a session are dropped silently. Example: 1234567, 89456123.

Note: You can paste a comma- or space-separated list (for example 1234567, 89456123 12345678) and each valid value is parsed into its own tag. Once 500 tags are reached, the input shows "Maximum of 500 NPNs reached." and stops accepting more.


Tracking Progress

While the lookup runs, a progress card replaces the input panel:

  • A spinning loader with the heading "Looking up NPNs..."

  • A counter that reads N of N processed

  • A progress bar with the percentage shown at its right

Results begin appearing in the table below as soon as the first batch returns from NIPR. You can read partial results, sort them, and search across them while the rest of the batch is still in flight.


Working With Results

When the lookup completes, the page shows four summary cards at the top, the results table below them, an Export CSV button in the top-right, and a New Lookup button below the table.

Summary Cards (Also a Filter)

The four cards above the table show counts by outcome and double as clickable filter toggles:

Card

Color

Meaning

Individuals

Primary (blue)

NPN resolved to an individual producer in NIPR.

Firms

Secondary accent

NPN resolved to a firm or agency record.

Not Found

Neutral (grey)

NIPR returned no record for this NPN.

Errors

Red

The lookup failed for this NPN (NIPR-side error, timeout, or transient issue).

Click any card to filter the table to just that outcome. Click it again to remove the filter. Activating all four at once is equivalent to clearing the filter, and every row shows.

Results Table

Column

Description

Name

The producer's full name or the firm's legal name. Sortable and searchable. Shows a dash when NIPR didn't return one.

ID

The NPN. For firms, the FEIN is also shown when available. Searchable.

Type

A colored badge: Individual, Firm, Not Found, or Error. Sortable.

Resident States

The states where the entity holds a resident license. The first four show inline with state circles; click the +N chip to expand the rest in a popover.

Additional Info

For individuals, shows Date of birth when NIPR provided it (with a copy control). Blank for firms, Not Found, and Errors.

The table's search box matches against Name and ID. Sorting is available on Name and Type. Pagination appears automatically when there are more than 10 rows.

Exporting Results

Click Export CSV in the top-right of the page to download the full result set as a CSV file. Active summary-card filters do not affect the export, so every row from the lookup is included.

Starting a New Lookup

Click New Lookup below the results to clear the current results, drop any active summary-card filters, and return to the input screen.


Filtering and Searching

The four summary cards are the only filter controls; each one toggles the table to a single outcome category.

Filter

Type

Purpose

Example use

Individuals card

Toggle

Show only individual producer results.

Reviewing producers for a personal-lines appointment? Click Individuals to hide the firms.

Firms card

Toggle

Show only firm or agency results.

Auditing the corporate entities behind a producer list.

Not Found card

Toggle

Isolate NPNs that returned no NIPR record.

Build a follow-up list for the carrier. These are usually typos or retired numbers.

Errors card

Toggle

Isolate NPNs whose lookup failed.

Copy these into a fresh manual-entry session to retry.

The search box on the table matches the producer or firm name and the ID column (NPN and FEIN). Partial matches work, so typing Trav finds Travelers, and typing the last few digits of an NPN finds that row.


Status Indicators

The Type column uses color-coded badges so each outcome is scannable at a glance. The same color scheme is reflected in the summary cards.

Color

Label

Meaning

What to do about it

Primary (blue)

Individual

NIPR returned an individual producer record.

No action needed. Use the name, NPN, and resident states downstream.

Secondary accent

Firm

NIPR returned a firm or agency record.

No action needed. Use the legal name, NPN, and FEIN downstream.

Neutral (grey)

Not Found

NIPR returned no record for this NPN.

Verify the NPN against your source. Common causes: a typo, a retired record, or a number that was never issued.

Red

Error

The NIPR call itself failed (network error, timeout, transient outage).

Filter to Errors, copy the NPNs, and retry them in a new manual-entry session.

If the whole job fails (for example, NIPR is unreachable or the session times out), a red banner appears at the top of the page with the error message and the input screen is restored so you can retry.


Frequently Asked Questions

How many NPNs can I look up at once? Each session supports up to 500 NPNs. If your file contains more, the list is capped at 500 in the review step. To process more than 500, run multiple sessions back-to-back.

What file types are supported for upload? CSV (.csv), text (.txt), Excel (.xls, .xlsx), and PDF (.pdf), up to 10 MB. Files outside this list are rejected with an inline error before extraction starts.

How does Turris extract NPNs from my file? Turris scans the file for numeric sequences that match the NPN format. For CSVs and spreadsheets, every cell is inspected; for PDFs, the text content is read. You can review and edit the extracted list before running the lookup.

What data does NPN Lookup return? For each NPN, Turris returns the producer or firm name, the entity type (Individual or Firm), the FEIN if it's a firm, the states where the entity holds a resident license, and the date of birth for individuals when NIPR provides it.

Why are some of my NPNs marked Not Found? "Not Found" means NIPR returned no record for that NPN. This usually points to a typo in the source data, a producer whose record is no longer active in PDB, or a number that was never issued. Verify each Not Found NPN against the original source before assuming it's invalid.

Why are some NPNs marked Error? "Error" means the NIPR request itself failed for that NPN, typically a NIPR-side error, a timeout, or a transient network issue. Errored NPNs can be retried in a new session and usually succeed on the second attempt.

Are results saved between sessions? No. NPN Lookup is a single-session tool. Results live only for the duration of 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 in the top-right downloads every result row. Filters applied to the on-screen table do not affect the export, so the full result set is included.

Does NPN Lookup change anything in my organization? No. NPN Lookup is read-only. It queries NIPR and renders the response. It does not create or modify any agents, agencies, licenses, or appointments in your account.


Best Practices

  1. Clean your source list before uploading. Remove header rows, duplicates, and obviously malformed numbers from the file. Extraction is permissive (it picks up anything that looks like an NPN), so the cleaner your source, the less you trim in the review step.

  2. Always review extracted NPNs. Extraction reads every numeric sequence in the file, including stray numbers in unrelated columns or footers. A quick scan of the review panel catches false positives before they spend an NIPR call.

  3. Export the CSV before navigating away. The result set exists only for the duration of the active session. Once you start a new lookup or close the tab, the results are gone unless you've exported them.

  4. Triage with the summary cards. Click Errors and Not Found to immediately isolate the problem records. Copy or export those subsets for follow-up rather than scrolling the full table.

  5. Retry errored NPNs in a separate manual-entry session. NIPR transient failures usually resolve on the next attempt. Filter to Errors, copy the NPNs, and paste them into a fresh manual-entry session, which is much faster than re-running the entire batch.


Need Help?

If you have questions about NPN Lookup or encounter any issues, contact our support team at support@turris.com.

Did this answer your question?