Overview

The Licenses tab on an agent's detail page is where you confirm one of your producers is licensed in every state they need to be, and spot the states where a license has already lapsed or is about to. Each state on the interactive U.S. map is color-coded by the most urgent license condition on file, so you can read the agent's nationwide footprint at a glance and click any state for the underlying license detail.

What is the Licenses Tab?

The Licenses tab turns the agent's NIPR-reported licenses into a single map answer to the question "is this producer properly licensed everywhere we place business?" It is read-only: the map reflects what NIPR returned for the agent's NPN at the last compliance data sync, so nothing here is edited by hand.

Who uses it. Licensing managers, compliance officers, and agency owners reviewing an individual producer, typically when onboarding a new agent, preparing for a state audit, or responding to a carrier or MGA appointment request that hinges on the agent's license status in specific states.

What you can do here:

See at a glance whether the agent holds at least one active license in every state where you place business
Spot states with an expired license so you can start a renewal or termination
Spot states with a license expiring within the next 60 days so you can renew before it lapses
Read each license's class name, class code, and expiration date by clicking the state
Get a four-bucket headline count (Licensed, Licensed / Expiring, Licensed / Expired, Unlicensed) of the agent's whole footprint

Accessing the Licenses Tab

Open Left sidebar → Agents. The agent list loads by default.
Click any agent row to open that producer's detail page.
Click the Licenses tab on the tab bar at the top of the detail page.

Note: If you arrive via an older bookmark that uses ?tab=licenses, Turris rewrites the address to ?selectedTabName=Licenses automatically and shows you the same view.

What's visible on the page

Element	Description
License Status by State (heading)	Section title anchored above the map.
U.S. map	An interactive map of all 50 states. Each state's fill color reflects the most urgent license condition the agent has on file there.
Territory legend	Small clickable squares beside the map for Puerto Rico, Virgin Islands, Guam, and District of Columbia, which the projected U.S. map cannot draw to scale.
State tooltip	Opens when you click a state or territory. Shows the full name, two-letter code, a total license count, and one row per license.
Map summary	Four cards below the map (Licensed, Licensed / Expiring, Licensed / Expired, Unlicensed), each counting how many jurisdictions fall into that bucket.

While the data loads, the map area shows a loading placeholder. If the agent's compliance data has not been synchronized from NIPR yet, the map and summary are replaced with the Compliance data not synchronized yet empty state (see §When Compliance Data Is Not Yet Synchronized below).

Reading the Map

When you'd do this. You've opened an agent's detail page to confirm the agent's licenses cover the states you place business in, or to check the agent's renewal exposure before requesting a carrier appointment.

Scan the overall color distribution for a quick read on the footprint. Lots of green means broad active coverage; any red or yellow flags states that need attention.
Click any state (or a square in the territory legend) to open its tooltip. The tooltip appears at the point you clicked.
In the tooltip, read each row for that jurisdiction:
- License class name with the license class code in parentheses, for example Producer (PR).
- An expiration line reading Expires on: for active or expiring licenses, Expired on: for licenses past their renewal date, or No expiration date when NIPR reports none. Dates render like Jun 16, 2026.
- A colored left border that mirrors the state color logic (red for expired, yellow for expiring, neutral for active).
Close the tooltip by clicking anywhere off it, pressing Escape, or scrolling the page.

Note: When a state holds a mix of license conditions, the most urgent one wins the color. Priority is Expired → Expiring → Licensed → Unlicensed. Always open the tooltip to inspect every license individually rather than relying on the state color alone.

Tip: The map only plots the agent's active NIPR licenses. Inactive, surrendered, or cancelled licenses are not shown, so a state with only a closed license appears gray (Unlicensed).

State Color Coding

Each state is filled with one of four colors, reflecting the most urgent license condition the agent has on file in that state.

Color	Label	Meaning	What to do about it
Red	Expired	The agent has at least one expired license in this state (today is on or after the day after the license's renewal date).	Click the state, identify the expired license class, and start a renewal or termination with the state regulator. Re-run the agent's compliance data sync once it's resolved so the map updates.
Yellow	Expiring	The agent has at least one license expiring within the next 60 days, and no expired license.	Click the state to read the expiration date, then renew with the state regulator before the deadline to keep coverage intact.
Green	Licensed	The agent has at least one active license in this state, with nothing expiring or expired.	No action needed. Re-sync periodically to keep the snapshot current.
Neutral (gray)	Unlicensed	The agent has no active license on file in this state from the most recent NIPR sync.	Confirm whether the agent should be licensed here. If so, verify the license is filed against the agent's NPN with the state regulator, then re-sync once NIPR has it.

Note: A license is treated as active through its renewal date and counts as expired the day after that date. A license whose next renewal date is today is still active, not expired.

Map Summary

Below the map, four cards count how many jurisdictions fall into each bucket. The counts span all 50 states plus the District of Columbia, Puerto Rico, the Virgin Islands, and Guam, and each card is color-matched to the state colors above.

Bucket	What it counts
Licensed	Jurisdictions where the agent has at least one active license that is neither expiring nor expired.
Licensed / Expiring	Jurisdictions with at least one license expiring within 60 days (and none expired).
Licensed / Expired	Jurisdictions with at least one expired license.
Unlicensed	Jurisdictions with no active license on file from the most recent NIPR sync.

The Licensed / Expiring and Licensed / Expired cards each carry a question-mark info icon next to the label. Click the icon to read the exact definition: "Number of states with at least one license expiring within 60 days" and "Number of states with at least one expired license," respectively.

Tip: Use the summary as a triage tool. If Licensed / Expired is non-zero, work that bucket first, since those licenses are already lapsed. Then move to Licensed / Expiring to head off the next wave of renewals.

When Compliance Data Is Not Yet Synchronized

The Licenses tab depends on a successful NIPR data sync for the agent. If the sync has not run, is still in progress, or failed, the map and summary are replaced with the Compliance data not synchronized yet empty state.

What the empty state shows:

A short explanation that the view draws from synchronized NIPR data and renders automatically once a sync completes.
The agent's Current sync status: as a status pill, for example Not started, Queued, Processing, Failed, NIPR error, Processing error, Manual review required, No data, Not applicable, Missing NPN, or Synchronized.
A hint reading "Find this agent in the list and click the Compliance Data column to start the sync."
A Go to Agents list button that returns you to the Agents list, where the sync is triggered from the Compliance Data column.

The map renders only once the agent's sync status is Synchronized.

Note: The sync runs against the agent's NPN. If the agent has no NPN on file, the sync cannot run, the status pill reads Not applicable or Missing NPN, and you'll need to add the NPN on the agent's profile before re-running the sync.

Frequently Asked Questions

Why does the page say "Compliance data not synchronized yet"? The Licenses tab draws from synchronized NIPR data, so the map cannot render until the agent's compliance data has been synchronized. Open the Agents list, find the agent, and start a sync from the Compliance Data column. Once it completes, return to this tab and the map populates automatically.

How does an agent's compliance sync get triggered? Compliance syncs are started from the Agents list using the Compliance Data column. The sync runs against the agent's NPN and refreshes the data behind the agent's Licenses, Other Names, and PDB Report tabs in one pass.

A license I expect to see is missing. What should I check? First confirm the agent's sync status is Synchronized. If it is and the license is still missing, NIPR did not return that license for the agent's NPN. Verify the NPN on the agent profile is correct and that the license is filed against that NPN with the state regulator. Once NIPR has the record, the next sync surfaces it on the map.

Can I edit a license from this tab? No. The Licenses tab is a read-only view of NIPR-reported data. Corrections are made with the relevant state regulator; once they flow into NIPR, the next compliance data sync refreshes the map.

How current is the data on this tab? Every state and license reflects the most recent NIPR Producer Database sync for the agent. Re-running the agent's compliance data sync refreshes the Licenses tab together with the Other Names and PDB Report tabs.

Why is a state gray when I know the agent is licensed there? A gray state means NIPR returned no active license for the agent in that state, even after a successful sync. Confirm the agent's NPN is correct on their profile and that the license is filed against that NPN at the state regulator. Once NIPR's record includes an active license, the next sync colors the state accordingly. Inactive, surrendered, or cancelled licenses never color a state.

What does "Expiring" actually mean? It is a fixed 60-day window. If at least one of the agent's active licenses in a state has a next renewal date within 60 days of today, that state is colored yellow. Even one expiring license turns the state yellow, regardless of how many healthy licenses the agent also holds there.

Best Practices

Confirm the sync is current before drawing any conclusions. A stale sync can hide a recent license addition, renewal, or termination. If the agent's status changed recently, re-run the compliance data sync from the Agents list before relying on the map.
Triage by color: red first, then yellow. Red states have at least one already-lapsed license; yellow states are within 60 days of lapse. Both warrant outreach, but red is more urgent.
Open the tooltip, don't rely on color alone. A red state may have one expired license out of many that are otherwise healthy. Click the state to confirm which specific licenses need action.
Cross-check gray states against your placement footprint. A gray state only matters if you actually need the agent licensed there. Compare the map against the states where you place business and follow up on the gaps that count.
Re-sync after a material change. When the agent completes a renewal, picks up a new state license, or has one terminated, re-run the compliance data sync from the Agents list so the map reflects the new state of the world.

Agents — The master roster of every producer associated with your organization across all of the agencies you manage.
Agent Detail — The single workspace for everything Turris knows about one of your producers: identity, agency assignments, license map, alternate names, and PDB report.
Agent Detail: Other Names Tab — Every alternate or historical name NIPR has on file for the producer, broken out by U.S. state.
Agent Detail: PDB Report Tab — A Producer-Database-style compliance summary consolidating demographics, contacts, addresses, licenses, appointments, and regulatory actions.