Skip to main content

Agency Detail Dashboard

Written by Sven Gerlach

Overview

The Agency Detail dashboard is where you size up a single agency in your organization at a glance: where it holds active licenses, where a license is about to lapse or has already expired, where it is unlicensed, the alternate legal names it is registered under by state, and the full Producer Database (PDB) compliance record. It opens on an interactive United States map and gives you what you need to answer "are we good to write in this state?" without leaving the page.


What is the Agency Detail Dashboard?

The Agency Detail dashboard is the per-agency drill-down reached from the Agencies roster. It answers three concrete questions for one company at a time: "Where are we licensed today, and is any of it expiring?", "Under what legal name are we registered in each state?", and "What does the agency's full NIPR record look like?"

Who uses it. Licensing managers, compliance analysts, and agency principals reviewing the licensure posture of one top company or one branch before a renewal, a new appointment, an audit, or a request from a market.

Key capabilities:

  • See, on a single colored map, every state where the agency is Licensed, has a license expiring within 60 days, has an expired license, or is Unlicensed.

  • Read the four-tile rollup beneath the map to count, at a glance, how many states fall into each of those four conditions.

  • Hover any state to read the exact license classes, class codes, and renewal or expiration dates the agency has on file in that jurisdiction.

  • Confirm which alternate or historical legal names the agency is registered under in each state before submitting a renewal, an appointment filing, or a license application.

  • Open the agency's full PDB report (firmographics, addresses, contacts, licenses, appointments, regulatory actions) and request a PDF copy by email for a regulator, a market contact, or an internal file.

The page chrome adapts to your organization category. If your organization is a TPA, Agency renders as Claims Org; a branch hierarchy may render it as Branch. Every reference to "agency" below uses whatever label your account is configured with.


Accessing the Agency Detail Dashboard

  1. Open Left sidebar → Agencies. The Agencies roster loads.

  2. Click any row in the Agencies table. The Agency Detail dashboard for that agency opens.

The page shows one entity at a time: the row you clicked, which is either your top company or a single branch underneath it.

What's on the page

A breadcrumb sits at the top of the screen reading Agencies → <Agency Legal Name>. Click Agencies in the breadcrumb to return to the roster. Below it, three tabs run across the content area:

Tab

What it shows

Licenses

Selected by default. A full-width United States map titled License Status by State, color-coded by the agency's license condition in each state, with a four-tile summary beneath it.

Legal Name by State

A table of every alternate or historical legal name NIPR has on file for the agency, broken out by state and branch.

PDB Report

The agency's full Producer Database compliance record (firmographics, addresses, and per-state contacts, licenses, appointments, and regulatory actions), with a Download PDF option.

Note: The Licenses and Legal Name by State tabs both require that NIPR data has been synchronized for the agency. Until the sync reaches Synchronized, those tabs show a "Compliance data not synchronized yet" prompt instead of the map or table. See When Compliance Data Hasn't Synced Yet below.


Reading the Licenses Map

When you'd do this. You want a five-second read of an agency's nationwide license posture before a renewal, an audit, or before answering "can we write business in state X?"

The Licenses tab is selected by default. It renders a United States map titled License Status by State. Each state is tinted by the most severe license condition the agency has on file there, and a four-tile summary sits beneath the map.

Map colors

A state is colored by its worst condition. The priority order is Expired > Expiring > Licensed > Unlicensed, so a state with one active license and one expired license renders red and the worst case is never hidden.

Color

Label

Meaning

What to do about it

Green

Licensed

The agency holds at least one active, non-expired license in this state.

No action. The state is in good standing as of the last sync.

Yellow

Licensed / Expiring

At least one license in this state renews within the next 60 days.

Start the renewal now through License Management so the license doesn't lapse.

Red

Licensed / Expired

At least one license in this state is past its renewal date.

Treat as urgent. The agency may be writing business it is no longer licensed for. Renew or reinstate without delay.

Gray

Unlicensed

No license data is on file for the agency in this state.

If you need to write business there, apply for the license. Otherwise no action. If you expected a license, re-sync the agency (see below).

Hovering a state

Hover any state to open a tooltip showing the full state name, its two-letter code, and a Total: N licenses count. Each license on file is listed with:

  • The license class name and class code in parentheses, for example Property (PR).

  • The renewal status: Expires: <date> for an active license, the same line tinted yellow when it is expiring, Expired: <date> in red when it is past due, or No expiration date when none is recorded.

If the agency holds no licenses in the hovered state, the tooltip reads No licenses.

Summary tiles

Four tiles beneath the map count how many states fall into each condition. Each tile is color-matched to its tint on the map.

Tile

What it counts

Licensed

States where the agency holds at least one active license.

Licensed / Expiring

The number of states with at least one license expiring within 60 days. Hover the info icon for the same definition inline.

Licensed / Expired

The number of states with at least one expired license. Hover the info icon for the same definition inline.

Unlicensed

States with no license data on file.


When Compliance Data Hasn't Synced Yet

When you'd see this. The Licenses and Legal Name by State tabs draw entirely from synchronized NIPR data. If a sync has not completed for the agency, the tab shows a "Compliance data not synchronized yet" panel in place of the map or table. The PDB Report tab shows the same panel when its data has not synced.

The panel reports the agency's current sync state in a Current sync status: pill, a one-line hint, and a Go to Agencies list button that returns you to the roster. The hint reads: "Find this agency in the list and click the Compliance Data column to start the sync." From the roster, click the Compliance Data column for the agency to start or finish the sync, then return to this dashboard.

Status pill

Meaning

What to do about it

Not started

No sync has been requested for this agency yet.

Open the Agencies list and click the agency's Compliance Data column to start the sync.

Queued / Processing

A sync is in progress.

Wait a few moments and refresh. The map and table appear automatically once the sync reaches Synchronized.

NIPR error / Processing error

The sync failed to retrieve or process data from NIPR.

Re-run the sync from the Agencies list. If it keeps failing, the most common cause is a missing or incorrect NPN on the agency record.

Not applicable

The agency has no NPN, so compliance data cannot be retrieved.

Confirm the agency's NPN on its record. NIPR data syncs require an NPN.

No data

NIPR returned no compliance records for this agency's NPN.

Verify the NPN is correct. If it is, NIPR simply has nothing on file for it.

Synchronized

The sync completed successfully.

None. The map and tabs render their data.


The Legal Name by State and PDB Report Tabs

These two tabs are documented in full in their own articles, linked under Related Pages. In brief:

  • Legal Name by State lists every alternate or historical legal name on file for the agency, with columns for State, Branch ID, Type (an Alias or Previously Known As badge), and Legal Name. Use it to confirm the exact name a state regulator has the agency registered under before you file.

  • PDB Report assembles the agency's full Producer Database record from the latest NIPR sync: a firmographics card, entity addresses, other names, and a per-state band for every state with records, each expanding to its contacts, addresses, licenses, appointments, and regulatory actions. Its header carries a Download PDF button: click it, pick which sections to include in the Email PDB report modal (Demographics, Contacts, Addresses, Licenses, Appointments, Regulatory Actions), then click Email me the PDF. The report is rendered server-side and emailed to your account address.

Tip: Switch to the Legal Name by State tab before typing in the page-level search box. That box drives the Legal Name by State table.


Filtering and Searching

The map on the Licenses tab has no filter controls; it always shows every state. Filtering and search behavior depends on which tab is active.

Tab

Filter / search behavior

Licenses

No filter controls. Hover any state on the map to inspect its licenses.

Legal Name by State

The page-level Search box at the top matches across State, Branch ID, Type, and Legal Name. Partial matches work, so typing part of a branch ID or a name narrows the list as you type. Click a column header to toggle its sort direction.

PDB Report

No filter controls. Click the state-code pill on any per-state band to expand it. States with zero records on file are hidden automatically.


Frequently Asked Questions

Why is a state gray when I know we're licensed there? Gray means Turris has no synced license data for the agency in that state. Either the most recent NIPR sync predates the license, or NIPR records it under a different branch than the one resolved for this agency. Run a fresh compliance sync from the Agencies list and re-check the map.

A state is red, but we renewed that license last week. Why? The map reflects the last NIPR sync, not real time. Renewals take time to post at NIPR, and Turris only sees them after the next sync. Trigger a new compliance sync from the Agencies list once the renewal has been recorded.

What counts as "expiring"? A license whose renewal date falls within the next 60 days. It turns yellow on the map and is counted in the Licensed / Expiring tile.

A state has one active license and one expired license. Why is it red and not green? The map colors each state by its worst-case condition so problems are never hidden. The priority is Expired > Expiring > Licensed > Unlicensed. Hover the state to read the per-license rows and confirm which licenses are active and which are expired.

Why do the Licenses and Legal Name by State tabs show an empty prompt? Both tabs require a completed NIPR sync. Until the agency's sync status reaches Synchronized, you'll see the "Compliance data not synchronized yet" panel with the current status and a link back to the Agencies list.

Can I send a copy to a regulator or a market contact? Yes. Open the PDB Report tab and click Download PDF. Choose the sections to include and the report is emailed to your account address as a PDF.

Does this dashboard cover the whole company or one branch? One entity at a time, whichever agency row you opened from the roster, whether that is the top company or a specific branch.


Best Practices

  1. Clear red states first. A red state means an expired license, which can mean the agency is writing business it is no longer licensed for. Work the red tile down to zero before anything else, then move to yellow.

  2. Re-sync before you trust the map. The map is only as current as the last NIPR sync. Before a renewal push or an audit, run a fresh sync from the Agencies list so the colors reflect today's reality.

  3. Hover before you drill. The state tooltip gives you the license class, class code, and renewal or expiration date without leaving the page. Use it as your first-pass triage before opening the PDB Report.

  4. Confirm the registered name before you file. Check the Legal Name by State tab before submitting a renewal, appointment, or license application, so the name on your filing matches the name the state has on record.

  5. Pull the PDB PDF for audits and market onboarding. When a regulator or a new market asks for proof of standing, the Download PDF option on the PDB Report tab gives you a clean, section-scoped record without manual assembly.


Related Pages

  • Agencies: your single inventory of the top company and every branch, with DRLP coverage and on-demand NIPR compliance syncs. This is the roster you open this dashboard from.

  • Legal Name by State: every alternate or historical legal name NIPR has on file for the agency, broken out by state and branch.

  • Agency Detail: PDB Report Tab: a Producer Database-style compliance snapshot of the agency, assembled from the latest NIPR sync and downloadable as a PDF.


Need Help?

If you have questions about the Agency Detail dashboard or encounter any issues, contact our support team at support@turris.com.

Did this answer your question?