---
title: "ProducerSync API Overview"
description: "A producer can only sell where they're licensed and appointed, and that status changes constantly — licenses lapse, appointments are terminated, regulatory actions get filed. Checking each producer by hand doesn't scale, and finding out late creates compliance risk."
url: "https://developer.agentsync.io/producersync-api-overview"
image: "https://developer.agentsync.io/_og/d/c_Ocean.takumi,title_ProducerSync+API+Overview,description_~QSBwcm9kdWNlciBjYW4gb25seSBzZWxsIHdoZXJlIHRoZXkncmUgbGljZW5zZWQgYW5kIGFwcG9pbnRlZCwgYW5kIHRoYXQgc3RhdHVzIGNoYW5nZXMgY29uc3RhbnRseSDigJQgbGljZW5zZXMgbGFwc2UsIGFwcG9pbnRtZW50cyBhcmUgdGVybWluYXRlZCwgcmVndWxhdG9yeSBhY3Rpb25zIGdldCBmaWxlZC4gQ2hlY2tpbmcgZWFjaCBwcm9kdWNlciBieSBoYW5kIGRvZXNuJ3Qgc2NhbGUsIGFuZCBmaW5kaW5nIG91dCBsYXRlIGNyZWF0ZXMgY29tcGxpYW5jZSByaXNrLg,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMxODdFRkYifX19,p_Ii9wcm9kdWNlcnN5bmMtYXBpLW92ZXJ2aWV3Ig,s_RJjuekiRcShg5jX3.png"
---

# ProducerSync API Overview

A producer can only sell where they're licensed and appointed, and that status changes constantly — licenses lapse, appointments are terminated, regulatory actions get filed. Checking each producer by hand doesn't scale, and finding out late creates compliance risk.

ProducerSync gives your systems that compliance picture directly from NIPR (the National Insurance Producer Registry), the industry's system of record, and notifies you when it changes.

**What you can get:**

-   **Licenses and appointments** — what a producer can sell, and where
-   **Regulatory actions** — disciplinary history on file with the states
-   **Producer details as the state has them** — addresses, contact information, biographical details, and alternative names

> **ProducerSync vs. Identity:** ProducerSync reflects what _the state_ knows about a producer, sourced from NIPR. The [Identity API](https://developer.agentsync.io/identity-api-overview) holds what _your organization_ knows — contact info, bank accounts, E&O coverage — which comes from you or the producer directly.

## [Common Use Cases](#common-use-cases)

**Carriers** — verify licensing status before appointment, monitor compliance across your distribution network, and track regulatory actions automatically.

**Managing General Agents (MGAs)** — validate credentials during onboarding and maintain a compliance database synced daily with NIPR.

**Technology partners** — integrate compliance data into agency management systems or producer portals, build automated compliance checkpoints, and develop regulatory reporting.

## [How It Works](#how-it-works)

### [NPNs](#npns)

Every insurance producer has a **National Producer Number (NPN)**, a unique identifier issued by NIPR. The NPN is the primary key across every ProducerSync endpoint: you query by NPN, subscribe NPNs for monitoring, and receive webhook events scoped to your NPN population.

### [Subscriptions and Your Monitored Population](#subscriptions-and-your-monitored-population)

To access data for a producer, you **subscribe** their NPN to your account. This adds them to your _monitored population_ — the set of NPNs AgentSync actively tracks for your organization.

Subscriptions matter for two reasons:

-   **Performance** — subscribed NPNs respond at P90 < 1s. Unsubscribed NPNs can take 10s+, as data must be fetched on demand.
-   **Webhooks** — `producersync.updates_available` covers your monitored population. It fires once per day, when AgentSync finishes processing NIPR's update across all your NPNs — a single "your data is ready" signal, not a per-producer notification.

> **Data for a newly subscribed NPN may not be immediately available.** It is retrieved from NIPR as your subscription job runs, which can take minutes to a few hours for large batches. Poll the job status endpoint to know when data is ready — see [Best Practices](https://developer.agentsync.io/producersync-api-best-practices).

### [NIPR Daily Update Cycle](#nipr-daily-update-cycle)

NIPR publishes updated producer data once per day. AgentSync processes it and fires a `producersync.updates_available` event carrying a `runDate`. Pass that `runDate` as the `updatedSince` query parameter to fetch only changed records — the recommended pattern for efficient daily sync.

> NIPR data is not real-time. Newly issued licenses or appointments may not appear until the following day's update cycle.

Two behaviors to plan for when reading collections:

-   **`includeDeleted` defaults to `true`** — NIPR-deleted records are returned unless you opt out. Filter them if your downstream system treats deletion as removal.
-   **v1 collection endpoints are deprecated.** `/v1/licenses`, `/v1/appointments`, and the rest were deprecated in October 2025. Use `/v2/` equivalents for all new integrations.

## [Getting Started](#getting-started)

**Start here:** the [ProducerSync API Quick Start Guide](https://developer.agentsync.io/producersync-api-quick-start-guide) covers authentication, subscribing your first NPNs, and setting up the daily sync workflow.

For every endpoint, query parameter, request/response schema, and field detail, see the interactive [API Reference](https://developer.agentsync.io/apis).

## [Customers with Manage](#customers-with-manage)

If you haven't purchased the ProducerSync API, you may be looking for Salesforce resources to interact with your Manage instance:

-   [Salesforce REST API Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/)
-   [Salesforce Data Loader Guide](https://help.salesforce.com/s/articleView?id=sf.data_loader.htm)
-   [Salesforce Data Limits Reference](https://help.salesforce.com/s/articleView?id=sf.data_limits.htm)