Overview

The License Compliance Agents page is the agent roster for a single onboarded agency. It lists every active producer attached to that agency with their NPN, resident states, and licensed-state footprint, lets you pull each agent's license and appointment data from NIPR, and is the doorway into an individual agent's compliance dashboard.

What is the License Compliance Agents Page?

This page answers a focused question: "Which producers at this agency have compliance data on file, and which still need it pulled?" The License Compliance overview tells you which of your agencies are ready; the Agency License Compliance dashboard tells you whether one agency is compliant; this page narrows to that agency's people so you can sync and inspect them one by one.

Who uses it. Licensing managers and compliance leads at a carrier, MGA, or wholesaler. They open this view to confirm the producer population of an agency they have onboarded, trigger the NIPR data pull for any agent whose data has not yet been synced, and drill into a specific agent's compliance dashboard when that agent is causing a gap.

From this page you can:

See every active agent attached to the agency in one table, with full name, email, NPN, resident states, and a count of states the agent is licensed in
Tell at a glance which agents still need a data pull by reading the Compliance Data Synchronization column
Start the NIPR sync for one agent without leaving the page, using the inline green sync button
Open an agent's Agent Compliance Dashboard by clicking any row whose Compliance Data Synchronization status is Success
Find one person inside a large roster by typing their name, email, NPN, or state into the search box

Accessing the Agents Page

You reach this page by drilling into a specific agency from the License Compliance area.

Open Left sidebar → License Compliance. The agency roster loads by default.
Find the agency you want in the table. At the end of that agency's row, click the Actions button (the three-dot ••• icon).
In the menu that opens, click Agents.

The Agents menu item is disabled (greyed out) when the agency has no agents on file. The sibling Agency menu item, which opens the Agency License Compliance dashboard, is disabled until the agency's own Compliance Data Synchronization status reaches Success.

Once the page loads, the title reads Agents with the subtitle "All agents associated with {agency name}". The breadcrumb at the top reads License Compliance › {Agency Name} › Agents and lets you step back to the agency roster in one click.

Note: This page is gated by the License Compliance product feature. If your organization's plan does not include License Compliance, the page is replaced by an upgrade notification. Non-customers who hover a row see a crown overlay; clicking it opens a message explaining the premium feature rather than navigating into the agent.

What's visible on the page

Column	Description
Agent	Round initials avatar followed by the agent's full name, with the agency's legal name in a smaller line below. Sortable by full name; the search box matches the full name.
Contact	The agent's email address. Shows a placeholder dash when no email is on file. The search box matches the email.
NPN	The agent's National Producer Number. The search box matches partial NPNs (a "contains" match).
Resident States	Stacked state badges for every state where the agent holds an active resident license, one badge per state. The search box matches both full state names and two-letter abbreviations. This column is not sortable.
Licensed States	A count of the unique states where the agent holds an active license (resident or non-resident), shown next to a star icon. Hover the column header for the tooltip "Aggregate number of unique states that the agent is licensed in".
Compliance Data Synchronization	A color-coded status badge for the agent's NIPR data pull. When the status is Not Started and the agent has an NPN, a green cloud-download button sits next to the badge so you can start the sync inline. Hover the column header for the tooltip "If you have not started the compliance data sync process yet you will see a green data sync button. Click this sync button to retrieve all of the agent's compliance data."

Pagination controls sit below the table. The default sort is by agent full name. You can re-sort by clicking the Agent, Contact, NPN, Licensed States, or Compliance Data Synchronization column header.

Opening an agent's compliance dashboard

Click any agent row whose Compliance Data Synchronization status is Success. The row opens the Agent Compliance Dashboard for that agent under this agency, where you can inspect license and appointment posture by product and state.

If you click a row whose status is anything other than Success, the row is non-actionable (rendered at reduced opacity with a "not allowed" cursor) and an informational message appears titled Missing Compliance Data: "To view the agent compliance dashboard for {agency name}, you first need to authorize the Compliance Data Synchronization process. Please navigate to the Agents tab where you can initiate the synchronization process." The word Agents in that message is a link to the Agents tab of the parent Associated Downstream Entity page, where the sync (including retries and bulk syncs) is set up.

Starting a Compliance Data Sync for an Agent

When you'd do this. An agent appears in the roster with a Not Started status, or a newly added producer has no compliance data on file yet. You need NIPR-sourced license and appointment data before you can open the Agent Compliance Dashboard for that agent or count them against any compliance check.

Locate the agent's row. The Compliance Data Synchronization column must read Not Started, and the agent must have a value in the NPN column. If either condition is unmet, no sync button renders for that row.
Click the green cloud-download icon to the right of the Not Started badge. Its tooltip reads "Start Data Synchronisation".
A confirmation dialog titled Data Synchronisation opens. It states that data synchronization charges apply in accordance with your contractual terms, and explains that the sync retrieves all of the agent's license and appointment data and may take a minute to complete.
Click Synchronize to start the pull, or Cancel to back out.
The agent's status moves through Queued and Processing to Success as NIPR returns data. The row becomes clickable as soon as the status reaches Success.

Tip: You can leave the page while a sync is in flight. The status badge reflects the latest state the next time you load the page, and the row becomes clickable automatically once the status flips to Success.

Warning: Synchronization is a billable action. The confirmation dialog warns that charges apply per your contract before any data is pulled, so review the terms before clicking Synchronize.

Note: The green sync button is hidden when the agent has no NPN. Agents without an NPN cannot be pulled from NIPR and stay in the Not Applicable state until an NPN is added to the agent record.

Filtering and Searching

There are no dropdown or badge filters on this page. The only narrowing control is the search box in the page header.

Filter	Type	Purpose	Example use
Search	Global text search	Narrow the table to a specific agent, email, NPN, or state.	Hunting for one person in a 200-agent roster? Type their last name to surface only their row.

The search box matches against the agent's full name, email, NPN (partial match), and resident-state name or two-letter abbreviation. Name, email, and state matching is fuzzy, so small typos still find the right row. Typing TX filters to agents with a Texas resident license; typing cali filters to California residents.

Compliance Data Synchronization Statuses

The Compliance Data Synchronization badge tells you whether you can drill into the agent yet.

Color	Label	Meaning	What to do about it
Grey	Not Started	The NIPR data pull has never been run for this agent.	Click the green cloud-download icon next to the badge to start the sync. The agent must have an NPN for the button to appear.
Blue	Queued	The sync request has been accepted and is waiting for capacity.	Nothing to do. The status moves to Processing automatically.
Yellow	Processing	NIPR accepted the request and the data is being ingested.	Nothing to do. Reload the page if you want to confirm progress; the status flips to Success when ingestion completes.
Green	Success	NIPR data has been pulled and processed. The row is clickable.	Click the row to open the Agent Compliance Dashboard for this agent.
Red	Error	Either NIPR returned an error or the response failed to process.	The inline sync button only appears for Not Started rows, so re-attempt the sync from the Agents tab on the parent Associated Downstream Entity page. If the error persists, contact support.
Grey	Not Applicable	The agent has no NPN on file, so no compliance data can be pulled from NIPR.	Add the agent's NPN to their record on the parent agency's Agents tab, then retry. Without an NPN the agent stays in this state.
Grey	No Data	NIPR returned a "no record found" response for the agent's NPN.	Verify the NPN on the agent record is correct. If the NPN is right, NIPR holds no compliance data for this producer.

Frequently Asked Questions

Why is an agent row greyed out and not clickable?

The agent's Compliance Data Synchronization status is anything other than Success. Rows become clickable only once the NIPR pull has succeeded, so the Agent Compliance Dashboard has data to render. Start or re-start the sync and wait for the status to reach Success.

Why don't I see a sync button for some agents in the Not Started state?

The inline sync button renders only when the agent has an NPN on file. Without an NPN, NIPR cannot return any data, so the button is hidden and the status reads Not Applicable. Add the NPN on the Agents tab of the parent Associated Downstream Entity page and the button appears.

Does syncing an agent cost money?

Yes. The confirmation dialog states that data synchronization charges apply in accordance with your contractual terms. Charges are incurred when you click Synchronize, not before.

Where do the Resident States and Licensed States values come from?

Both are derived from the agent's NIPR data after a successful sync. Resident States are the unique states where the agent holds an active resident license. Licensed States is the deduplicated count of every state where the agent holds an active license, regardless of residency.

Can I sync every agent at once?

Not from this page. Bulk synchronization is initiated from the Agents tab on the parent Associated Downstream Entity page. This view is for inspecting one agency's agents and starting per-agent syncs as needed.

An agent shows an Error status. How do I retry?

The inline green button only appears for Not Started rows, so it won't show for an Error row. Re-run the sync from the Agents tab on the parent Associated Downstream Entity page, or click the agent row to open the Missing Compliance Data message, which links you straight to that tab.

Best Practices

Sync new agents in one sitting. When several producers show Not Started, click the green sync icon on each before moving on. The pulls run independently and each row becomes clickable as soon as its sync completes.
Review the charges note before syncing. Each sync is billable per your contract. Confirm you intend to pull the data before clicking Synchronize, especially when working through a large roster.
Treat Not Applicable rows as missing NPNs. A Not Applicable status almost always means the agent's NPN field is empty. Add the NPN on the parent agency's Agents tab rather than re-discovering the same gap later from the Agent Compliance Dashboard.
Resolve Error rows from the parent Agents tab. A red Error badge blocks every downstream compliance check for that agent, and this page has no inline retry for it. Re-run the sync from the Associated Downstream Entity page and escalate to support if it repeats.
Drill into the lowest Licensed States counts first. A low count is often the first sign that an agent is missing key resident or non-resident licenses for the product lines you write. Sort by Licensed States to bring those agents to the top.

License Compliance: Your starting point for monitoring every onboarded agency at a glance, with one-click sync and drill-down into each agency's dashboard or agent roster.
Agency License Compliance: Product-by-product, state-by-state view of whether a single agency holds the right licenses and appointments to sell each of your products.
Agent Compliance Dashboard: The deepest drill-down inside License Compliance, showing whether one producer is licensed and appointed in every state your product is distributed in.