Overview
The Agent Detail page is the single workspace for everything Turris knows about one of your producers. You open it from the Agents list and land on a tabbed dashboard that pairs the producer's identity, agency assignments, and NIPR sync status with a license map, alternate names, and a full Producer Database (PDB) compliance report, so you can confirm who the producer is and resolve any compliance question without leaving the page.
What is the Agent Detail Page?
The Agent Detail page is the per-producer dashboard for an agent associated with your organization. It loads when you click a row in your Agents list, opens on the Overview tab by default, and exposes the rest of the producer's compliance data behind a four-tab strip.
Who uses it. Compliance and licensing staff at agencies, agency networks, wholesale brokerages, and third party administrators use this page to verify a producer's identity, confirm where they are licensed to sell, audit per-state regulatory records, and trigger a fresh NIPR sync when the data looks stale. Your organization category controls the wording used for producers throughout the app: agencies, agency networks, and wholesale brokerages see Producers, while third party administrators see Adjusters. The behavior of the page is identical in every case; only the label changes.
Key capabilities:
Confirm a producer's identity at a glance using their full name, NPN (with a click-to-copy control), and an SSN-on-file indicator.
See every agency in your organization the producer is currently assigned to.
Read the producer's NIPR Compliance Data Synchronization status and start a fresh sync from the same card when one has not yet been run.
Scan a U.S. map of the producer's state-by-state license footprint, with a four-tile summary of how many states are Licensed, Licensed / Expiring, Licensed / Expired, and Unlicensed.
Inspect any alternate names (current Alias or historical Previously Known As) on file by state.
Read the producer's full Producer Database compliance report state by state, and request a PDF copy delivered to your email.
Accessing the Agent Detail Page
Open the left sidebar and click Producers (this entry reads Adjusters if your organization is a third party administrator). The Agents list loads.
Click any row in the table to open that producer's detail page.
The page opens on the Overview tab. Use the tab strip below the page header to switch to Licenses, Other Names, or PDB Report at any time.
The breadcrumb at the top of the page shows the Agents list link followed by the producer's full name. Click the first breadcrumb to return to the list without losing your filter or sort state.
Element | What it shows |
Breadcrumb | The Agents list link (labeled Producers or Adjusters) followed by the producer's full name once the page loads. |
Identity heading | The producer's first and last name, with the static label "Insurance Agent" beneath it, inside the Overview tab's first card. |
Tab strip | Overview, Licenses, Other Names, PDB Report. The active tab is reflected in the URL through the |
Tab content | The view for the currently selected tab. |
Note: The Licenses, Other Names, and PDB Report tabs all depend on synchronized NIPR data. Until the producer's Compliance Data Synchronization reaches Success, those tabs render a "Compliance data not synchronized yet" empty state instead of the underlying records.
Reviewing the Overview Tab
When you'd do this. Start on the Overview tab any time you open a producer. It is the fastest way to confirm you are looking at the right person (name plus NPN), to check whether the NIPR sync has run, and to see which of your agencies the producer is currently assigned to.
The tab is split into two cards.
Producer Identity Card
Field | What it shows |
Name | First and last name as the heading, with "Insurance Agent" beneath. |
NPN | National Producer Number. Hover the value to reveal a copy icon, then click the value to put it on your clipboard. A dash is shown when no NPN is on file. |
SSN | A green check icon when an SSN is on file, or a gray cross icon when none is on file. The SSN value itself is never displayed. |
Compliance Data Synchronization | The current NIPR sync status as a colored badge (see "Status and Visual Elements"). A cloud-download Sync button sits next to the badge and appears only when the sync has not yet started. |
Associated Agencies Card
The Associated Agencies card lists every agency in your organization the producer is currently assigned to. Each agency renders as a chip showing its legal name. When the producer has no active agency associations, the card reads "This agent has not been assigned to any agencies yet."
Tip: Run the Sync button on this tab before you rely on the Licenses, Other Names, or PDB Report tabs, especially for a producer you just added. All three of those tabs are populated by the same NIPR pull.
Synchronizing Compliance Data
When you'd do this. Run a sync the first time you add a producer, or whenever the data on the downstream tabs looks stale and you want the latest license and appointment information from NIPR.
On the Overview tab, find the Compliance Data Synchronization field in the Producer Identity card.
Click the cloud-download Sync button next to the status badge. This button appears only when the status is Not Started and the producer has an NPN on file. If you do not have permission to sync, the button surfaces an access notice instead of triggering the sync.
The Agent Data Synchronisation confirmation dialog opens. It explains that the sync retrieves all of the producer's license and appointment data and may take a minute to complete.
Click Start Synchronization to begin, or Cancel to dismiss without syncing.
The status badge moves to Queued, then Processing, and finally Success when the data is ready. The Licenses, Other Names, and PDB Report tabs populate automatically once the status reaches Success.
Note: If the status badge reads Not Applicable, the producer has no NPN on file and a sync is not possible. Add the NPN from the Agents list first, then return here to sync.
Reviewing the Licenses Tab
When you'd do this. Use the Licenses tab when you need to see where a producer is licensed to sell, find states with licenses that are about to lapse, or chase down an expired license that may be blocking a placement.
The tab shows a colored U.S. map titled License Status by State. Each state is shaded by the strongest license condition on file for the producer. Below the map, a four-tile summary counts the states in each bucket.
Summary tile | Meaning |
Licensed | States with at least one active license and no expiration concerns. |
Licensed / Expiring | States with at least one license expiring within the next 60 days. An info tooltip on the tile confirms the 60-day window. |
Licensed / Expired | States with at least one expired license. An info tooltip on the tile confirms this. |
Unlicensed | States with no active license records on file. |
Hover any state on the map to open a tooltip that lists the full state name, the state code, the total count of licenses on file, and a card per license. Each license card shows the class name and class code together, plus a date line that reads "Expires on:
" for an active or expiring license, "Expired on:
" for an expired license, or "No expiration date" when none is recorded. Expired cards are tinted red, expiring cards yellow, and active cards have a green accent.
Note: If the producer's Compliance Data Synchronization is anything other than Success, the tab renders the "Compliance data not synchronized yet" empty state instead of the map. Start a sync from the Overview tab's Sync button (or from the Compliance Data column on the Agents list) to populate the data.
Reviewing the Other Names Tab
When you'd do this. Use Other Names when a carrier or counterparty mentions a name you do not recognize, when reconciling a producer who has rebranded, or when investigating a possible duplicate record. Alternate names are tracked per state because NIPR reports them per state.
Column | Description |
State | A stacked state badge plus the full state name. Sortable, and the table is sorted by state code ascending by default. |
Type | Alias for a currently used alternate name, or Previously Known As for a historical name. Previously-known-as rows are styled in italics. |
Name | The alternate name itself. Previously-known-as entries render in gray italics so they read as historical context. |
A search box above the table filters rows by state name, type, or the name itself. Matching is fuzzy, so partial entries work.
The table falls back to "We don't have information about other names by state for this producer." when no records are on file.
Note: Other Names also depends on a successful Compliance Data Synchronization. Until NIPR returns data, the tab renders the "Compliance data not synchronized yet" empty state instead of the table.
Reviewing the PDB Report Tab
When you'd do this. Use the PDB Report tab when a carrier asks for full producer-database details, when reconciling a regulatory action, or when you need a point-in-time snapshot of the producer's compliance posture to attach to a market submission or audit response.
The tab opens with a header titled PDB Report, a one-line description ("Producer-database-style compliance summary assembled from synchronized NIPR data."), and a Download PDF button on the right.
Beneath the header sits a Demographics card showing the producer's identity record.
Field | Description |
Full Name | First, middle, and last name as returned by NIPR. |
NPN | National Producer Number with a copy control. |
Date of Birth | Formatted date of birth on file. |
Gender | Gender on file, as reported by NIPR. |
Citizenship | Country of citizenship on file. |
Main Email | Primary email returned by NIPR. |
Additional Emails | Comma-separated list of any non-primary emails. Only shown when present. |
Any Other Names on file are also surfaced inside the Demographics card as pill-style entries, each showing the name, an Alias or Previously Known As tag, and the state code.
Below the Demographics card, the producer's per-state records render as a stack of collapsible accordions, one per state that has records. Each accordion header shows a state-code chip and the total record count for that state (for example, "12 records"). Expanding an accordion lazy-loads that state's data and groups it into up to five subsections, each with its own count badge.
Subsection | What it contains |
Contacts | Mailing and business contacts reported for the producer in that state. |
Addresses | Legal and mailing addresses on file for that state. |
Licenses | License records for the state, with class, status, and renewal details. |
Appointments | Carrier appointments active in that state. |
Regulatory Actions | Regulatory actions filed against the producer in that state. |
States with no records across all five subsections are hidden so the report stays scannable. When no states have any records at all, the tab shows a "No per-state records on file" card instead of an empty list. For a full walkthrough of this tab, see the dedicated PDB Report article linked under "Related Pages."
Downloading the Report as a PDF
When you'd do this. Request a PDF when you need to email an artifact to a carrier or auditor, attach a snapshot to a ticket, or archive a point-in-time copy of the producer's posture.
Click Download PDF in the tab header.
The Email PDB report modal opens. It confirms which producer the report is for and the email address the PDF will be delivered to (your account email).
Choose which sections to include. Every section is selected by default. Use the checkboxes described in the table below.
Click Email me the PDF. The button is disabled until at least one section is selected, and an inline note reads "Select at least one section to include in the PDF." while none are checked.
The modal closes and the request is queued. The PDF is generated by a background process and arrives at your account email when it is ready.
The section checkboxes in the modal:
Section | Required | Description |
Demographics | At least one section required | Identity record at the top of the report. |
Contacts | At least one section required | Per-state contacts grouped under each state. |
Addresses | At least one section required | Per-state legal and mailing addresses. |
Licenses | At least one section required | Per-state license records with classes, statuses, and renewal dates. |
Appointments | At least one section required | Per-state carrier appointments. |
Regulatory Actions | At least one section required | Per-state regulatory actions on file. |
Click Cancel to dismiss the modal without queuing a render. While a request is in flight, the modal cannot be dismissed by clicking the backdrop or pressing Escape.
Tip: The emailed PDF is a point-in-time snapshot. If you need a fresh report after a new NIPR sync, run Sync from the Overview tab first, wait for the status to return to Success, then download again.
Filtering and Searching
The only filter on this page is the search box on the Other Names tab. It narrows the alternate-names table as you type.
Filter | Type | Purpose | Example use |
Search (Other Names tab) | Text box above the table | Match a row by state name, type, or the alternate name itself. | Looking for how a producer appears in Texas? Type |
Matching is fuzzy, so partial and mid-word entries are found. The table is sorted by state code ascending by default, and the State, Type, and Name columns are each sortable.
Status and Visual Elements
Color | Label | Where it appears | What it means | What to do about it |
Neutral | Not Started | Compliance Data Synchronization badge | The NIPR sync has not yet been run for this producer. | Click Sync next to the badge on the Overview tab to start the sync. |
Blue | Queued | Compliance Data Synchronization badge | The sync is in the queue waiting for a worker. | Wait. The badge updates automatically when the worker picks the job up. |
Yellow | Processing | Compliance Data Synchronization badge | The worker is currently pulling and parsing NIPR data. | Wait. The Licenses, Other Names, and PDB Report tabs populate when the status flips to Success. |
Green | Success | Compliance Data Synchronization badge | The most recent NIPR sync completed successfully and the downstream tabs render real data. | No action needed. Re-sync only if the data looks stale. |
Red | Error | Compliance Data Synchronization badge | The last sync failed, either because NIPR returned an error or because processing the response failed. | Re-run the sync. If the error persists, confirm the NPN is correct and open a support ticket. |
Neutral | Not Applicable | Compliance Data Synchronization badge | The producer has no NPN on file, so a sync is not possible. | Add the NPN on the agent's record from the Agents list, then run Sync. |
Neutral | No Data | Compliance Data Synchronization badge | NIPR returned a response indicating no compliance data exists for the NPN. | Confirm the NPN is correct. If it is, NIPR has no record for this producer. |
Green check | SSN on file | Overview identity card | An SSN is stored for this producer. The value is never displayed. | None. The indicator is informational. |
Gray cross | SSN not on file | Overview identity card | No SSN is stored. | Add the SSN on the agent's record from the Agents list if your workflow requires one. |
Green | Active license | License tooltip on the Licenses tab | The state's license is active with no expiration concerns. | None. |
Yellow | Expiring license | License tooltip on the Licenses tab | At least one license in that state expires within 60 days. | Coordinate renewal with the producer before the date shown. |
Red | Expired license | License tooltip on the Licenses tab | At least one license in that state is past its renewal date. | Trigger renewal immediately. The producer cannot sell in that state until the license is current. |
Italic gray | Previously Known As | Other Names tab and Demographics card | A historical legal name reported by NIPR. | None. Historical context only. |
Frequently Asked Questions
Why are the Licenses, Other Names, and PDB Report tabs empty or showing a sync prompt? Those tabs are powered by synchronized NIPR data. If the producer's Compliance Data Synchronization is anything other than Success, the underlying records have not been pulled yet. Use the Sync button on the Overview tab to start a fresh sync; the tabs populate automatically once the status reaches Success.
The producer's NPN looks wrong. Can I edit it from this page? No. The Agent Detail page is read-only for identity fields. Update the NPN, name, or other details from the Agents list. After the next NIPR sync runs, this page reflects the corrected data. Note that the NPN cannot be changed once compliance data has been synced.
Why is the SSN shown as a check or a cross instead of a number? Turris never displays SSNs in the UI. The check or cross is an "on file" indicator only. It confirms whether an SSN has been recorded for the producer so you know the field is populated.
Why does the Licenses map show a state as Unlicensed even though I know the producer is appointed there? Appointments and licenses are tracked separately. The Licenses map reflects only active state license records returned by NIPR. Appointments appear in the PDB Report tab. A producer can be appointed in a state without holding a personal license there.
How do I download the PDB report as a PDF? On the PDB Report tab, click Download PDF in the tab header. Choose which sections to include (all six are selected by default), then click Email me the PDF. The PDF is generated in the background and emailed to your account email. Allow a few minutes for delivery.
Why does the Other Names tab show both an Alias and a Previously Known As entry for the same state? NIPR can track more than one name per state when a producer has rebranded or migrated identifiers. Alias rows are current alternate names. Previously Known As rows are kept for historical context and styled in gray italics so they are easy to skim past.
Can I share a link to a specific tab? Yes. The active tab is reflected in the URL through the selectedTabName query parameter. Copy the URL while on the tab you want to share, and the recipient lands on the same tab when they open it, subject to their permissions.
Why does the page label producers as "Adjusters" or use different wording than I expect? Turris localizes terminology to your organization category. Agencies, agency networks, and wholesale brokerages see "Producers"; third party administrators see "Adjusters". The behavior of the page is identical; only the labels change.
Best Practices
Start on the Overview tab when investigating a producer. It confirms identity (name and NPN), surfaces the current sync status, and shows the agency assignments before you drill into a specific compliance question.
Run a fresh sync before trusting the downstream tabs. A producer who was added recently, or who has not synced in a while, may be showing stale NIPR data. Click Sync from the Overview tab, wait for the badge to flip to Success, then return to the Licenses, Other Names, or PDB Report tab.
Use the Licensed / Expiring tile as a renewal triage view. It flags every state with a license renewing within the next 60 days, the window where most preventable lapses occur. Schedule renewal outreach before the dates shown in the tooltip.
Cross-reference the PDB Report tab when a record looks wrong. The accordion view by state matches the structure of the NIPR-issued report and is the same data the carrier sees. If your data disagrees with what the producer's carrier shows, the PDB Report tab is the authoritative comparison.
Download the PDB report as a PDF when you need to share posture externally. The emailed PDF is point-in-time, archivable, and easy to attach to a market submission, audit response, or support ticket.
Related Pages
Agents: The master roster of every producer across all of the agencies you manage, and where you open an agent's detail page from.
Agent: Licenses Tab: A deeper reference for the Licenses tab, including the U.S. map color coding and the four-tile summary.
Agent Detail: Other Names Tab: Detailed reference for the Other Names tab and how alternate names are reported per state.
Agent Detail: PDB Report Tab: Full reference for the PDB Report tab, including each section's content and the PDF download flow.
Need Help?
If you have questions about the Agent Detail page or encounter any issues, contact our support team at support@turris.com.