Skip to main content

Agent Detail

Written by Sven Gerlach

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

  1. Open the left sidebar and click Producers (this entry reads Adjusters if your organization is a third party administrator). The Agents list loads.

  2. Click any row in the table to open that producer's detail page.

  3. 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 selectedTabName query parameter, so a link to a specific tab is shareable.

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.

  1. On the Overview tab, find the Compliance Data Synchronization field in the Producer Identity card.

  2. 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.

  3. 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.

  4. Click Start Synchronization to begin, or Cancel to dismiss without syncing.

  5. 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.

  1. Click Download PDF in the tab header.

  2. 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).

  3. Choose which sections to include. Every section is selected by default. Use the checkboxes described in the table below.

  4. 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.

  5. 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 Texas (or part of the name) to surface just the matching rows.

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Did this answer your question?