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
Open Left sidebar → Agents. The Agents list loads with every agent in your tenancy.
Click any row to open the agent's detail page.
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, |
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.
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.
Click the band header. The band slides open and loads the state's records on demand.
While the records load, you see the Loading {state code} branded loader with the messages "Fetching state records" and "Grouping by section".
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 |
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 |
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, |
Order Length | Length of any associated order, formatted as |
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.
Click Download PDF at the top-right of the PDB Report tab header.
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."
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. |
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."
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
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.
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.
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.
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.
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.
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.