Skip to main content

Agent Detail: PDB Report Tab

Written by Sven Gerlach

Overview

The PDB Report tab on an agent's detail page is your single-screen, Producer-Database-style compliance summary for that agent. Use it when you need to confirm an agent's identity, see every state they have on file, drill into their licenses, appointments, and regulatory history, or send a stakeholder a clean PDF copy of any part of the report.

What is the PDB Report Tab?

The PDB Report is where you review an agent's full NIPR footprint without leaving Turris and request a shareable PDF copy of any subset of it.

Who uses it. Licensing managers and compliance analysts at upstream entities (carriers, MGAs, wholesalers) who need to audit an agent's standing across every jurisdiction, prepare onboarding or appointment paperwork, or respond to a regulator inquiry without juggling raw NIPR exports.

From this tab you can:

  • Confirm an agent's identity at a glance: full name, NPN, date of birth, gender, citizenship, and every email NIPR has on file

  • See every alternate name reported for the agent (DBA, former, fictitious) and the state each name applies to

  • Open any state where the agent has activity and inspect its Contacts, Addresses, Licenses, Appointments, and Regulatory Actions in one place

  • Read each license's class, number, residency, renewal dates, line-of-authority breakdown, and continuing-education status without leaving the page

  • Verify which carriers currently have the agent appointed in each state, and which appointments are nearing or past their last status change

  • Email yourself a tailored PDF of the report after picking which sections to include

Accessing the PDB Report Tab

  1. Open Left sidebar → Agents. The Agents list loads with every agent in your tenancy.

  2. Click any row to open the agent's detail page.

  3. Click the PDB Report tab in the tab bar above the page content. The agent detail page has three inner tabs: Overview, Agencies, and PDB Report.

While the report assembles, the page shows the branded Turris loader with the title "Assembling the PDB report" and the rotating messages "Pulling compliance records", "Grouping data by state", and "Compiling the report".

What's visible on the page

The tab header sits at the top, followed by the Demographics card, then a vertical stack of collapsible state bands, one per state where the agent has at least one record on file.

Element

Description

PDB Report heading

Page title at the top-left of the tab. The subtitle reads "Producer-database-style compliance summary assembled from synchronized NIPR data."

Download PDF button

Outline button at the top-right of the page header, with a download icon. Opens the Email PDB report modal.

Demographics card

Card directly below the header. Shows the agent's identity fields and any Other Names on file.

State bands

Collapsible rows below the Demographics card. Each band shows a primary-tinted two-letter state code pill on the left and the total record count on the right (for example, 12 records, or 1 record when only one).

States with zero records are hidden. If the agent has no per-state records at all, the page shows "No per-state records on file" in place of the state stack.

When the data is not yet synchronized

If the agent has not completed an NIPR data sync, the tab renders the Compliance data not synchronized yet empty state instead of the report. The empty state shows the agent's current sync status as a pill next to the Current sync status: label (for example, Not started, Queued, Processing, Failed, NIPR error, or Manual review required), a one-line hint ("Find this agent in the list and click the Compliance Data column to start the sync."), and a Go to Agents list button. From the list you can find the agent and start the sync from the Compliance Data column.

When the report fails to load

If the request to fetch the report errors out, the tab shows an Unable to load PDB report card asking you to refresh the page or try again in a few moments. Per-state record fetches use a separate request: if a single state errors, you see Unable to load {state code} records, and the fix is to collapse and re-open that band to retry.

Reading the Demographics Card

The Demographics card at the top of the page collects the identity fields NIPR returns for the agent. Its subtitle reads "Source-of-truth identity fields for the producer." Blank fields show a short dash.

Field

Description

Full Name

First, middle, and last name concatenated as reported by NIPR.

NPN

The agent's National Producer Number. Hover the NPN to reveal the copy control and copy it to the clipboard with one click.

Date of Birth

The agent's date of birth, formatted to match the rest of the app.

Gender

The reported gender.

Citizenship

The agent's country of citizenship.

Main Email

The primary email address NIPR has on file for the agent.

Additional Emails

Comma-separated list of every other email on file (the main email is excluded). Shown only when at least one additional email exists.

Other Names

Below the identity grid, the Other Names strip lists every alternate name reported for the agent. Each entry is a pill row containing:

  • The alternate name itself (or a short dash when NIPR returns the entry without a name string)

  • A type badge with the NIPR-supplied name type (for example, DBA, former, fictitious)

  • An uppercase two-letter state code when the name is state-scoped, omitted when the name applies nationally

The Other Names strip is hidden when the agent has no alternate names on file.

Opening a State Band

When you'd do this. You're auditing the agent in a specific state, confirming a license is still active before approving an appointment, or pulling the full per-state record set for a regulator response.

  1. Locate the state in the stack. The two-letter state code pill and the record count on the band header tell you how much is inside before you expand.

  2. Click the band header. The band slides open and loads the state's records on demand.

  3. While the records load, you see the Loading {state code} branded loader with the messages "Fetching state records" and "Grouping by section".

  4. Click the header a second time to collapse the band. Each state is independent: opening one does not close another.

Note: Records are fetched the first time you open a state, then kept for the rest of the session, so subsequent opens are instant.

Once the band is open, the contents are grouped into up to five sections: Contacts, Addresses, Licenses, Appointments, and Regulatory Actions. Each section header shows its name next to a small count pill (for example, Licenses with a 3 pill). Sections with zero records are omitted entirely.

Contacts

Every contact value NIPR returns for the state appears as its own row, grouped by channel. A single contact record can produce up to three rows (one each for Business Email, Business Phone, and Fax).

Field

Description

Business Email

Email address NIPR reports for business contact in this state.

Business Phone

Phone number on file.

Fax

Fax number on file.

Updated

Right-aligned date showing when NIPR last refreshed the value. Hidden when NIPR didn't report a date.

Empty channels are skipped, so a state with only a business phone on file produces a single row.

Addresses

Each address NIPR returns for the state renders as its own row with a leading map-pin icon and a colored type badge.

Field

Description

Type

Badge with the address type: Residence, Business, Mailing, or Unknown.

State / Country

Inline label like IL · USA. The state code matches the band you're inside.

Street

Address lines 1, 2, and 3 joined with commas. Shows a short dash when no street is on file.

City / ZIP

City name and ZIP code on a line below the street.

Updated

Small date label when NIPR reported a last-updated value.

Licenses

Each license renders as its own card so you can read the renewal timeline at a glance.

Card header

Element

Description

License class

License class name (for example, Producer, Adjuster) as the card title.

Class / number line

Subtitle in the form Class {code} · License # {number}.

Status badge

Colored badge at the top-right of the card with the license status: Active (green) or Inactive (neutral).

License details grid

Field

Description

Residency

The agent's residency status for the license: Resident, Non-resident, or Non-resident (no home state).

Issued

The date the license was first issued.

Last Renewal

The most recent renewal date on file.

Next Renewal

The upcoming renewal date.

Lines of Authority sub-table

Below the grid, the Lines of Authority sub-table lists every LOA on the license. When NIPR returns no LOAs, you see the inline note "No lines of authority on file."

Column

Description

Line of Authority

LOA name (for example, Property, Casualty, Life).

Code

The NIPR code for the LOA, in a monospaced font.

Status

NIPR-reported LOA status: Active, Inactive, Expired, Suspended, Pending Renewal, Cancelled, or any other status NIPR returns (capitalized).

Status Reason

The free-text reason NIPR supplies, with the reason date in parentheses when available.

Continuing Education

The LOA-level continuing-education badge plus renewal date and credits needed, when reported.

License-level Continuing Education

The bottom panel of the card shows the license's CE status: the In compliance / Exempt / Not in compliance / Not supplied badge, the next CE renewal date, and how many credits are still needed when NIPR provides them. When NIPR returned no license-level CE, you see "No license-level CE on file."

Appointments

Every appointment NIPR has on file for the state renders in a table.

Column

Description

Carrier

The appointing carrier's name.

Company Code

The carrier's NIPR company code, in monospace.

EIN

The carrier's EIN, in monospace.

Line of Authority

LOA name on the first line, LOA code in muted text on the second.

Status

Badge for the current appointment status: Appointed (green), Terminated (red), Expired (red), Expiring (yellow), or Not Appointed (neutral).

Last status change

Date the appointment last changed status. The column header carries an info tooltip: "We currently track the last-known status change date for the appointment, not the original appointment date."

Termination Reason

NIPR-reported reason, populated only when the status is Terminated.

Regulatory Actions

Every regulatory action NIPR has reported for the state is listed here.

Column

Description

Action ID

The unique NIPR action identifier, in monospace.

Date of Action

The date the action was issued.

Effective Date

The date the action took effect.

Origin

Free text NIPR returns (for example, the state insurance department name).

Reason

Reason cited for the action.

Disposition

Final disposition NIPR returns.

Penalty / Fine

Monetary penalty, formatted as USD with no fractional cents (for example, $2,500). Shows a short dash when zero.

Order Length

Length of any associated order, formatted as {n} day or {n} days. Shows a short dash when zero.

Downloading a PDF Copy

When you'd do this. You need to send the agent's compliance picture to someone who doesn't have a Turris seat (your VP of Compliance, a partner carrier, or a regulator), or you want a timestamped archival copy of the report as it stands today.

  1. Click Download PDF at the top-right of the PDB Report tab header.

  2. The Email PDB report modal opens. It first confirms the subject ("Request a PDB report for {agent name}. Choose which sections to include."), then where the file goes: "We'll email the PDF to {your email} when it's ready." when your account email is loaded, otherwise "We'll email the PDF to your account email when it's ready."

  3. Every section is checked by default. Uncheck the sections you don't want in the PDF:

Field

Required

Description

Demographics

At least one section

Identity fields, NPN, citizenship, additional emails, and the Other Names strip.

Contacts

At least one section

Per-state business email, phone, and fax rows.

Addresses

At least one section

Per-state addresses with type, location, and last-updated date.

Licenses

At least one section

Every license card, including lines of authority and CE status.

Appointments

At least one section

Per-state appointments table.

Regulatory Actions

At least one section

Per-state regulatory actions table.

  1. Click Email me the PDF. The button is disabled until at least one section is selected. If you uncheck everything, you see the inline warning "Select at least one section to include in the PDF."

  2. On success, the modal closes and a confirmation appears ("We'll email the PDF shortly", "Sent to {your email}."). The PDF is rendered on our servers and emailed to your account address when it's ready.

Tip: Need only a license snapshot? Uncheck every section except Licenses to keep the PDF compact when you're sharing it with a single-purpose stakeholder.

Note: While the request is being submitted, you can't dismiss the modal by clicking the backdrop or pressing Escape, and Cancel is disabled. Wait for the submission to finish, or click Cancel before submitting.

Status Values and Badges

The same vocabulary is used across every per-state section. Each row below names the badge color, the label, the meaning, and the action you'd typically take.

License status

Color

Label

Meaning

What to do

Green

Active

The license is currently active in the state.

No action required. Confirm the renewal dates on the card to plan ahead.

Neutral

Inactive

The license is no longer active.

Investigate the LOA status reasons inside the card and, if the agent should be writing in this state, work with the state regulator to reinstate before re-syncing.

Line-of-authority status

NIPR returns a variable set of LOA status values. The PDB Report capitalizes anything outside the known set.

Label

Meaning

What to do

Active

LOA is in good standing for this license.

No action needed.

Inactive

LOA has been deactivated.

Check the Status Reason and reason date for context.

Expired

LOA term has lapsed.

Pursue renewal or schedule a re-sync after renewal is complete.

Suspended

LOA suspended by the regulator.

Read the Status Reason carefully. This typically requires regulator follow-up.

Pending Renewal

Renewal is in progress with the state.

Monitor and re-sync after the state issues the renewal.

Cancelled

LOA was cancelled.

Confirm with the agent whether they intend to reinstate.

Continuing-education status

Color

Label

Meaning

What to do

Green

In compliance

CE requirements have been met for the cycle.

No action required.

Primary

Exempt

The agent is exempt from CE for this license (for example, long-tenured residents in certain states).

No action required, but verify the exemption is still valid before the next renewal.

Red

Not in compliance

CE requirements have not been met.

Coordinate with the agent on remaining credits. The Credits needed value on the row tells you exactly how many are outstanding.

Neutral

Not supplied

NIPR did not return a CE status.

If CE is required in this state, verify directly with the regulator.

Appointment status

Color

Label

Meaning

What to do

Green

Appointed

The agent is currently appointed by the carrier in the state.

No action required.

Red

Terminated

The appointment has been terminated.

Read the Termination Reason column. If termination was unintentional, reach out to the carrier to re-appoint.

Red

Expired

The appointment expired.

Re-appoint with the carrier if the agent still writes the line.

Yellow

Expiring

The appointment is approaching expiration.

Coordinate with the carrier ahead of the change date to keep production lines uninterrupted.

Neutral

Not Appointed

The carrier has no current appointment on file for the agent in this state.

If the agent needs to write for this carrier here, initiate the appointment with the carrier.

Frequently Asked Questions

Why does the page say "Compliance data not synchronized yet"? The PDB Report renders only after a successful NIPR data sync. Until the sync reaches Synchronized status, the empty state shows the current sync status and a Go to Agents list button so you can return to the list and start (or troubleshoot) the sync.

Why are some states missing from the report? States with zero records on file across all five sections are hidden. The page focuses on jurisdictions where the agent has at least one contact, address, license, appointment, or regulatory action.

A state I expected to see is missing. What should I check? Confirm the sync status reads Synchronized. If the sync completed and the state is still missing, NIPR did not return any records for that jurisdiction. Verify the agent's license footprint with the state regulator if the absence is unexpected.

What's the difference between Other Names on the Demographics card and Contacts inside a state band? Other Names captures alternate identities for the agent (DBA, former, fictitious). The per-state Contacts section is about communication channels (business email, business phone, and fax) for the agent in that state.

Can I edit anything on this tab? No. The PDB Report is a read-only view of NIPR-reported data. Corrections must be filed with the relevant state regulator. Once they flow into NIPR, the next compliance data sync refreshes the report.

How current is the data? It reflects the most recent NIPR sync for this agent. Re-running the agent's compliance data sync refreshes every section together: demographics, contacts, addresses, licenses, appointments, and regulatory actions.

Where does the PDF get sent? To the email tied to your Turris account. The download modal confirms the destination email before you submit, and the success confirmation repeats it.

I requested a PDF but didn't receive it. What should I do? Check your spam or junk folder first. PDF rendering can take a moment for agents with many states or many licenses. If the email still hasn't arrived after several minutes, re-submit the request from the Email PDB report modal. If the problem persists, contact support.

Best Practices

  1. Confirm the sync status before drawing conclusions. Always verify the agent is in Synchronized status before treating a missing license or appointment as authoritative. A failed or queued sync is the most common cause of unexpected gaps.

  2. Triage by state band header. The two-letter state code pill and the total record count let you scan dozens of states in seconds. Open only the bands that matter for the question you're answering.

  3. Plan renewals from the License card grid. Issued, Last Renewal, and Next Renewal are the fastest way to size up upcoming renewal work, especially when paired with the LOA continuing-education status.

  4. Act on Expiring appointments early. Rows with status Expiring are days or weeks from expiration. Coordinate with the carrier ahead of the change date so production lines stay open.

  5. Trim the PDF to the audience. Deselect everything except the section the recipient cares about (Licenses for a partner carrier, Regulatory Actions for a compliance officer) to keep the document tight and on-topic.

  6. Re-sync after material updates. When the agent renews a license, picks up an appointment, or resolves a regulatory matter, run the compliance data sync again before pulling a fresh PDF. Every section refreshes together.

Related Pages

  • Agents: Your master roster of every producer writing business across your agencies, with NIPR compliance pulls, branch reassignment, and per-row drill-in.

  • Agent: Overview Tab: The default landing view on the agent detail page, pairing identity fields with a snapshot of every agency the agent is placed at.

  • Agent Detail: Agencies Tab: Every agency in your tenancy the agent is currently writing for, with the ability to add associations from the page.

  • Agent: Authority Tab: A per-agency, per-product authority map plus a state-by-state license-and-authority view for each product.

  • Agent: Licenses Tab: State-by-state licenses pulled from the agent's most recent NIPR Producer Database sync, with authorities and renewal dates.

  • Agent: Appointments Tab: Every state-level carrier appointment Turris has synchronized from NIPR for the agent.

Need Help?

If you have questions about the PDB Report tab or encounter any issues, contact our support team at support@turris.com.

Did this answer your question?