Overview
The Agents tab in License Management is the producer-focused view of your licensing program. It lists every agent attached to your organization, summarizes where each one holds licenses, and lets you trigger an NIPR data sync, drill into an agent's per-state license breakdown, or submit a new license request without leaving the page.
What is the Agents Tab?
The Agents tab is where you keep tabs on the individual producers in your organization so you know whether each one is licensed where they need to be writing business. Each row represents one agent and pulls together their identifiers, their resident-state picture, a count of states they are licensed in, and the current status of their compliance-data sync with NIPR.
Who uses it. Licensing managers, compliance leads, and agency principals who are responsible for keeping individual producer licensing current. It is the entry point you use when you need to verify an agent's licensure, kick off the first NIPR data pull for a newly added producer, or request a new license on a specific producer's behalf.
From the Agents tab you can:
See every producer associated with your organization (and its branches) on a single screen, with name, NPN, the agencies they belong to, their domicile states, and a count of states where they are licensed
Tell at a glance which agents already have synchronized compliance data and which ones still need it pulled from NIPR
Trigger a one-click compliance-data sync for any agent who has not been synced yet
Open an agent's per-state license dashboard by clicking the row once their sync reaches Success
Narrow the list to a specific agency (or set of agencies) when you only want the producers attached to that book of business
Submit a new license request for one or more producers across one or more states without leaving the page
Note: Depending on your organization type, the "Agents" label can render as "Producers" or "Adjusters" (the latter for Third Party Administrators). The page automatically reflects your organization's terminology in every column header, filter label, and breadcrumb, and "Agencies" similarly renders as the entity label that fits your organization.
Accessing the Agents Tab
In the left sidebar, click License Management. The first tab, Actions Required, loads by default.
In the secondary nav at the top of the License Management view, click Agents. The other tabs in this row are Actions Required, License Requests, and Agencies.
License Management is a premium feature. If your organization's plan does not include it, you see a "License Management" feature notification with a request-access option instead of the table.
What's visible on the page
Element | Purpose |
Secondary nav (Actions Required, License Requests, Agencies, Agents) | Switches between the four License Management views. |
Filter Associated Agencies dropdown | Narrows the table to agents who belong to one or more selected agencies; supports multi-select and Select All. |
New button (top-right of the page header) | Opens the Request New License slide-over for submitting a new license request. |
Search box (top bar) | Filters the visible rows by agent name, NPN, or associated agency name. |
Agents table | One row per agent with summary columns plus the Compliance Data Synchronization status. |
Agents table columns
Column | Description |
Agent (label tracks your org's terminology) | Producer's full name with a circular avatar of their initials. Hover the name to reveal a copy control. |
NPN | National Producer Number with a copy control on hover. |
Agencies (label tracks your org's terminology) | The agencies this producer is attached to, shown as neutral pills. If the agent belongs to more than three agencies, the first two appear inline and the rest are grouped behind a |
Domicile States | Stacked state-code circles for the agent's resident states. A blue circle marks a resident state where they hold an active license; a grey circle marks a resident state where they do not. A long dash is shown when the agent has no resident state on file. |
Licensed States | Total number of U.S. states and territories in which the agent currently holds at least one active license, per NIPR. |
Compliance Data Synchronization | Current NIPR sync status (see the Status Indicators section). When the status is Not Started, a green cloud-download button appears next to the badge for a one-click sync. |
Hover over the Domicile States or Compliance Data Synchronization column headers for an inline tooltip describing what the indicators mean.
To open an individual agent's detail page, click anywhere on a row whose Compliance Data Synchronization status reads Success. Rows in any other status are dimmed and show a not-allowed cursor; clicking them surfaces a "Compliance Data Unavailable" notice instead of navigating.
Synchronizing an Agent's Compliance Data
When you'd do this. A producer was just added to your organization (or a row still shows Not Started) and you need their NIPR-sourced licenses, lines of authority, expiration dates, and residency information to populate the rest of the License Management experience for them. Until this sync runs, the row is locked and you cannot drill into the agent's per-state dashboard.
In the Compliance Data Synchronization column, find a row whose status badge reads Not Started.
Click the green cloud-download icon to the right of the badge (titled Start Agent Data Synchronisation on hover). The button only renders when the status is Not Started and the agent has an NPN on file.
A confirmation modal appears explaining what the sync will do. Confirm to start it.
The status badge moves to Queued, then Processing, and finally to Success when the data has been retrieved and ingested. Status changes update automatically.
Once the badge reads Success, the row becomes clickable and the Licensed States count and Domicile States circles populate.
Tip: You can trigger syncs for several agents back-to-back without waiting for each one to finish. Each sync runs independently and the badges update on their own when complete.
Note: If the agent has no NPN on file, the sync button does not render and the row stays at Not Started until an NPN is added on the agent's profile.
Opening an Agent's License Detail
When you'd do this. You want the state-by-state license picture for one specific producer: which states they are licensed in, what lines of authority they hold, and which licenses are expiring or already expired.
Locate the agent in the table. Use the Filter Associated Agencies dropdown or the Search box to narrow the list quickly.
Check that the Compliance Data Synchronization column on that row reads Success. Rows in any other status are dimmed.
Click anywhere on the row.
The page navigates to that agent's per-state license dashboard, where you can review each state's licenses, see expiration dates, request renewals, and request additional lines of authority.
Note: Clicking a row whose status is not Success displays the alert "Compliance Data Unavailable: the [agent] compliance dashboard is not available because this [agent] does not have synchronized data yet." Run the sync first, then re-click the row.
Requesting a New License
When you'd do this. You need to apply for one or more new state licenses on behalf of one or more agents (or agencies) in your organization. This is the same flow exposed from the License Management page header on every tab, but starting it from the Agents tab keeps you in producer context.
Click the New button in the top-right of the page header.
The Request New License slide-over opens with the subtitle "Fill out this form to request assistance with adding internal licenses".
Fill in the form, in order. Each field appears only after the one above it is set:
Field | Required | Description |
Select Entity Category | Yes | Choose whether the request is for agents or agencies. The agent option's label tracks your org's terminology. A help icon next to the label explains: request a new license for the agencies or agents that already have an NPN. |
Select Entities | Yes | Multi-select of the agents (or agencies, depending on the category) the request applies to. Supports Select All. An entity that cannot be selected because of a data blockage (for example, a missing NPN or NIPR data subscription) cannot be added; attempting to select it shows an alert naming the reason. |
Select States | Yes | Multi-select of the U.S. states and territories the new license should cover. Supports Select All. |
License class and LOAs (per state) | Yes | A separate card renders for each state you chose. For each state, pick the license class and the lines of authority. |
Click Submit. The button shows a loading state while the request is being submitted.
On success, a "License request(s) have been successfully submitted" alert appears and you are redirected to the License Requests tab, where you can track the progress of each request.
Tip: You can combine multiple agents with multiple states in a single submission. Turris creates an individual license request for each agent-and-state combination and groups them on the License Requests tab.
Warning: If an agent is missing required data (for example, an NPN or a current NIPR data subscription), they are flagged as unavailable in the Select Entities picker and an alert explains the reason. Resolve the data gap on the agent's profile before resubmitting.
Filtering and Searching
One filter dropdown sits above the table, and one search box sits in the top bar.
Filter | Type | Purpose | Example use |
Filter Associated Agencies | Multi-select dropdown with Select All | Narrow the table to producers who belong to one or more selected agencies. The dropdown label tracks your org's terminology. | A multi-branch broker filtering down to just the East-coast office's producers. |
A help icon next to the filter explains that you can view all agents or filter to specific ones by selecting one or more associated agencies.
The Search box in the top bar shows a magnifier icon and a "Search..." placeholder. Type to filter the visible rows (matching is debounced as you type and reflected in the page URL). It matches on:
Agent name (fuzzy match: typing
SmfindsSmith)NPN (substring match)
Agencies (fuzzy match against the legal names of the producer's associated agencies)
The Domicile States, Licensed States, and Compliance Data Synchronization columns are not matched by the search box.
Status Indicators
Compliance Data Synchronization
Color | Label | Meaning | What to do about it |
Neutral (grey) | Not Started | The NIPR data sync has never been run for this agent. | Click the green cloud-download button next to the badge to start the sync. The row stays locked until a sync completes. |
Blue | Queued | A sync has been requested and is waiting to run. | Nothing. Wait; the badge moves to Processing automatically. |
Yellow | Processing | A sync is actively running. | Nothing. When it finishes the badge moves to Success and the row becomes clickable. |
Green | Success | The agent's NIPR data is current. | Click the row to open the per-state license dashboard for this agent. |
Red | Error | The most recent sync failed (NIPR returned an error, or our processing of the NIPR response failed). No sync button is shown for this status. | Re-check the agent's NPN on their profile. If the NPN is correct, contact support so we can investigate the failed sync. |
Neutral (grey) | Not Applicable | The agent has no NPN, so a compliance-data sync is not possible. | Add an NPN to the agent's profile if one exists. Without an NPN the row stays locked. |
Neutral (grey) | No Data | NIPR returned no compliance data for this agent's NPN. | Verify the NPN is correct. If it is and you still expect data, contact support so we can confirm NIPR's response. |
Domicile State Circles
Color | Label | Meaning | What to do about it |
Blue | Resident state with active license | The producer is a resident in this state and holds at least one active license there. | Nothing. This is the expected state. |
Grey | Resident state without active license | The producer is a resident in this state but does not currently hold an active license there. | Treat as a compliance gap. Use the New button or the agent's per-state dashboard to request the missing license. |
Long dash | No resident state on file | The agent has no resident state recorded. | Confirm the agent's compliance data has finished syncing. If it has and the dash persists, NIPR has no residency on file; verify the NPN on the agent profile. |
Frequently Asked Questions
Why can I not click on an agent's row? The row only navigates to the agent's per-state dashboard when Compliance Data Synchronization reads Success. For any other status the row is dimmed and shows a "Compliance Data Unavailable" alert when clicked. Run the sync (or correct the underlying issue) and the row unlocks.
Why does the sync button only appear on some rows? The cloud-download button renders only when the status is Not Started and the agent has an NPN on file. Once you click it, the status moves through Queued and Processing to Success (or Error), so the button disappears for the rest of the lifecycle. For Error rows there is no in-table retry; contact support so we can investigate the failed sync.
What does the sync actually do? The sync asks NIPR for the latest compliance information on file for the agent's NPN, including every active license, line of authority, expiration date, and residency designation. That data is what populates the Licensed States count, the Domicile States circles, and the per-state dashboard you see when you click the row.
My agent shows zero Licensed States. Why? Either the agent's compliance data has not been synchronized yet (check the status column), or NIPR has no active licenses on file for this NPN. Re-run the sync once the NPN is confirmed correct; if the count still shows zero, the agent genuinely holds no active state licenses today.
Why does an agent appear under multiple agencies? Some producers are attached to more than one of your agencies. Each agency they belong to shows up in the Agencies column. Use the Filter Associated Agencies dropdown to narrow the table to producers who belong to a specific agency you are working with.
Can I export the Agents list? The Agents list itself is not exported from this page. To export license data, switch to the Actions Required tab, which supports CSV export for the licenses currently flagged as expiring or expired, or drill into an individual agent's dashboard.
How is the Licensed States count calculated? It is the count of distinct U.S. states and territories in which the agent currently holds at least one active license according to NIPR. The number updates whenever a sync completes.
Best Practices
Sync compliance data on day one. As soon as a producer is added to your organization, click the cloud-download button on their row to pull NIPR data. Without a sync, the row stays locked and downstream features (per-state detail, renewals, license requests scoped to that agent) are unavailable.
Re-run syncs after major licensing events. When you know an agent has added a state license or appointed at a new market, run a fresh sync so the Domicile States circles, Licensed States count, and per-state dashboard reflect the new state of record.
Use the Associated Agencies filter when scrolling gets tedious. Multi-branch brokers and TPAs benefit from narrowing to one agency at a time, especially once the producer roster grows beyond a few dozen rows.
Track outcomes on the License Requests tab. When you submit a request through the New button, status updates land on License Requests, not back on Agents. Build that into your post-submission workflow.
Treat persistent Error rows as a data-quality signal. A row that stays in Error after a confirmed-correct NPN almost always points to something NIPR cannot resolve. Loop in support early instead of re-running the sync repeatedly.
Related Pages
License Management - Actions Required: the License Management landing tab, collecting every license on your agencies and agents that is expiring or already expired so you can request renewals before lapses interrupt the producer's ability to write business.
License Requests: tracks every renewal and new-license filing your team has asked Turris to submit, split across Renewals and New Licenses tabs with each filing's current status.
License Management: Agencies: the agency-level view inside License Management, with one row per agency showing identifiers, domicile states, licensed-state count, and current NIPR sync status.
Need Help?
If you have questions about the Agents tab or encounter any issues, contact our support team at support@turris.com.