Overview
The License Compliance page is your starting point for monitoring every onboarded agency at a glance: each agency's identifiers, resident states, licensed-state footprint, agent count, and whether its compliance data has been pulled from NIPR yet. From here you trigger a one-click data sync for any agency that has an NPN but has not been synchronized, then drill into either the agency's compliance dashboard or its agent roster.
What is License Compliance?
License Compliance is where a licensing manager keeps tabs on the readiness of every onboarded agency before a renewal cycle, an audit, or onboarding into a new state.
Who uses it. Licensing managers and compliance leads at carriers and MGAs who need to know, before they appoint or distribute through an agency, whether that agency's license data is current and which states it covers.
It lets you:
See every onboarded agency in one paginated, searchable, sortable table, with each branch and DBA shown under its legal name
Read each agency's NPN, FEIN, and Producer Code without leaving the page
See which states an agency holds a resident license in, alongside the total count of licensed states
Track how many active agents are tied to each agency
Tell at a glance whether an agency's compliance data has been pulled from NIPR, is in progress, has failed, or is unavailable
Pull compliance data from NIPR for any agency that has an NPN but has not yet been synchronized, directly from the table
Jump straight into the Agency compliance dashboard or the Agents view for any synced agency
Accessing License Compliance
Left sidebar → License Compliance (the shield-check icon). The page renders one row per onboarded top-level agency, with branches and trade names nested beneath their parent.
What's visible on the page
Column | Description |
Agency | The agency's legal name. If the branch name differs from the legal name it appears on a second line; if the Doing Business As name differs it appears on a line prefixed with |
ID | A stacked identifier cell combining the agency's NPN, FEIN, and Producer Code. Empty identifiers are hidden. Not sortable. |
Resident States | Stacked two-letter state circles for every state where the agency holds a resident license. Hover any circle to reveal the full state name. Not sortable. |
Licensed States | The aggregate count of unique states the agency is licensed in (resident or non-resident), followed by a star badge. Not sortable. |
Agents | The count of active agents currently associated with the agency, followed by a sales-agent icon. Sortable. |
COMPLIANCE DATA SYNCHRONIZATION | A status pill (see the Compliance Data Synchronization Status Legend below). When the status is Not Started and the agency has an NPN, a green cloud-download button appears next to the pill so you can launch a sync without leaving the table. Sortable. |
Actions | A three-dot popover at the end of each row with two quick-jump items: Agency (opens the per-agency compliance dashboard) and Agents (opens the per-agency agent roster). |
How to drill in
Click anywhere on a row to open that agency's compliance dashboard. Row clicks only succeed when the COMPLIANCE DATA SYNCHRONIZATION status is Success — clicking a non-synced row opens an information alert instead (see the alerts described under Synchronizing Compliance Data).
Use the Actions popover (the three-dot icon at the end of the row) when you already know your destination. The Agency item is disabled until the sync status is Success; the Agents item is disabled when the agency has zero agents.
Note: Rows whose sync status is anything other than Success appear with reduced opacity and a "not allowed" cursor as a visual reminder that the per-agency dashboard is not yet reachable.
Synchronizing Compliance Data for an Agency
When you'd do this. You've just onboarded a new agency with a valid NPN, or an existing agency's row shows Not Started, and you want NIPR's license and appointment data pulled in before opening the agency's compliance dashboard.
Locate the agency in the table. The COMPLIANCE DATA SYNCHRONIZATION column shows a green cloud-download button whenever the status is Not Started and the agency has an NPN on file. Hovering the button shows Start Data Synchronization.
Click the green cloud-download button next to the status pill. A confirmation modal titled Data Synchronisation opens.
Review the modal copy before continuing:
Data synchronization charges apply in accordance with your contractual terms.
Synchronization retrieves all of the agency's license and appointment data and may take a minute to complete. Once it finishes, you can inspect the agency's compliance against your product- and state-specific requirements.
Click Synchronize to start the pull, or Cancel to back out.
The status pill moves through Queued → Processing → Success. Once Success appears, the row becomes clickable and the per-agency compliance dashboard is available.
Tip: If an agency has no NPN, the COMPLIANCE DATA SYNCHRONIZATION column shows an N/A badge instead of a sync button. A question-mark icon next to the badge explains that sync is unavailable because the agency does not have an NPN.
Note: The green sync button only appears for agencies in Not Started state. To start or re-run a sync for an agency that is in Error, No Data, or any other state, use the Agencies page (left sidebar → Agencies), where the full synchronization workflow lives.
What happens when you click a non-synced row
Clicking a row whose status is not Success opens an information alert rather than navigating. The wording depends on the agency's NPN state:
Situation | Alert heading | What it says |
Agency has an NPN but has not synced yet | Missing Compliance Data | You must first authorize the Compliance Data Synchronization process. The alert links to the Agencies table where you can start the sync. |
Agency has no NPN, and an NPN is expected | Compliance Data Unavailable | The dashboard is unavailable because the agency has not yet provided its NPN. |
Agency has no NPN, and none is expected | Compliance Data Unavailable | The dashboard is unavailable because the agency has no NPN, so no compliance data exists. |
Filtering and Searching
A Filters bar sits directly above the table. It contains a single search box, a question-mark help popover, and (when you arrived via an agent deep-link) an agent-scope chip. There is no separate filter panel — column sorting handles the rest.
Control | Type | Purpose | Example use |
Search | Free-text input bound to the URL's | Narrow the table to agencies whose name, branch, DBA, or identifiers match | Typing |
Column sort | Click a sortable column header | Reorder the list by Agency, Agents, or COMPLIANCE DATA SYNCHRONIZATION | Click Agents to surface the agencies with the most producers first |
What the search matches. The search runs server-side as a case-insensitive substring match across each top-level agency's:
Agency legal name
Branch name
Doing Business As (DBA) name
NPN
FEIN
Producer Code
Search activates once you type at least 2 characters — a single character returns the full list so you keep seeing content while you type. The term is reflected in the URL as ?search=<term>, so deep links and bookmarks preserve the active query.
Note: Search matches a top-level agency's own fields only. It does not match the legal name of a nested branch row, so searching for a branch name will not surface its parent unless the parent's own identifiers also match.
Agent-scoped view
When you reach this page from an agent's detail sidebar (via that agent's License Compliance link), the list is automatically filtered to only the agencies that agent is associated with. A pill in the Filters bar reads Filtered to (agent name). While this scope is active, clicking a synced row opens that agent's compliance dashboard rather than the agency dashboard. Click the X on the pill to clear the scope and return to the full list.
The list is paginated: use the page-size selector and the page navigation at the bottom of the table to move through larger sets of agencies.
Compliance Data Synchronization Status Legend
The pill in the COMPLIANCE DATA SYNCHRONIZATION column reflects the latest NIPR data subscription state for the agency.
Color | Label | Meaning | What to do about it |
Neutral (gray) | Not Started | No sync has been initiated yet. When the agency has an NPN, a green cloud-download button sits next to this pill so you can start one. | Click the green sync button to pull NIPR data. If there is no button, the agency has no NPN — add the NPN on the agency profile first. |
Blue | Queued | A sync has been requested and is waiting to be picked up. | No action required. The status moves to Processing automatically. |
Yellow | Processing | The sync is currently running against NIPR. | Wait for the status to transition to Success. This typically takes about a minute. |
Green | Success | The most recent sync completed successfully. The row becomes clickable and the per-agency compliance dashboard is available. | Click the row to open the dashboard, or use the Actions popover to jump to Agency or Agents. |
Red | Error | Either NIPR returned an error or our worker failed while processing NIPR's response. | Re-run the sync from the Agencies page. If the error persists, contact support. |
Neutral (gray) | No Data | NIPR returned no records for the agency's NPN. | Verify the NPN on the agency profile. If the NPN is correct, the agency may genuinely have no NIPR-registered licenses yet. |
Neutral (gray) | N/A | The agency has no NPN on file, so compliance data sync is not possible. A question-mark icon next to the badge confirms this. | Add the NPN to the agency profile if one exists. If not, the agency cannot be tracked through NIPR. |
Frequently Asked Questions
Why is a specific agency's row faded out and unclickable? The agency's compliance data has not yet been successfully synced. Rows are only clickable when the COMPLIANCE DATA SYNCHRONIZATION status is Success. Start a sync from this page if the green sync button is available, or visit the Agencies page if it is not.
Why does an agency show "N/A" instead of a sync button? The agency does not have an NPN on file. Compliance data is sourced from NIPR using the NPN, so without one the sync cannot run. If the agency should have an NPN, add it from the agency's profile and the row will switch to Not Started.
What is the difference between Resident States and Licensed States? Resident States are the states where the agency holds a resident license, shown as stacked state circles. Licensed States is the total count of unique states (resident or non-resident) the agency is licensed in.
How do I sort the table? Click the header of the Agency, Agents, or COMPLIANCE DATA SYNCHRONIZATION column. Click again to reverse the direction. The ID, Resident States, and Licensed States columns are not sortable.
Why doesn't my search find a branch by its name? Search matches each top-level agency's own legal name, branch name, DBA, NPN, FEIN, and Producer Code. It does not search the fields of nested branch rows on their own, so a branch surfaces only when its parent agency's identifiers also match. Search also needs at least two characters before it filters.
How often does the compliance data refresh? Each agency's compliance data reflects its most recent NIPR sync. You can re-run the sync at any time from the Agencies page; for an agency in Not Started state, you can also trigger the first sync directly from this page.
Can I see compliance data for a specific product or state from this page? No. This page is the high-level entry point. To inspect product- and state-level license and appointment compliance, open an agency's row (or use the Actions menu) to reach the per-agency compliance dashboard.
Why am I only seeing some of my agencies, with a "Filtered to" pill at the top? You arrived here from an agent's detail page, so the list is scoped to the agencies that agent is associated with. Click the X on the Filtered to pill to clear the scope and see every onboarded agency.
Will my charges go up if I trigger a sync? Yes, in accordance with your contractual terms. The Data Synchronisation confirmation modal calls this out explicitly before the sync starts. If you are unsure about the cost, cancel and check your contract or reach out to support.
Best Practices
Sync new agencies promptly. As soon as an agency is onboarded with an NPN, click the green sync button so the per-agency dashboards and downstream features become usable.
Watch for red Error pills. They mean NIPR or our processing returned an error. Re-run the sync from the Agencies page; if the error persists, contact support so the underlying issue can be diagnosed.
Search before scrolling. The search box matches name, branch, DBA, NPN, FEIN, and Producer Code in one box — it is almost always faster than paging through the table.
Use the Actions menu when you know your destination. The three-dot popover saves a click when you already know whether you need the Agency dashboard or the Agents view.
Verify missing NPNs. If an agency shows N/A, confirm whether it is expected to have an NPN. If so, record it on the agency profile to enable compliance data sync.
Related Pages
Agency License Compliance — The per-product, per-state dashboard for a single agency, with color-coded license and appointment status across every state.
License Compliance: Agents — The roster of every agent at an onboarded agency, with NPN, resident states, sync controls, and drill-down into each agent.
Agent Compliance Dashboard — The per-product, per-state dashboard for an individual producer — the deepest drill-down inside License Compliance.
Need Help?
If you have questions about License Compliance or encounter any issues, contact our support team at support@turrisfi.com.