Get regulatory actions for a specific NPN
Returns all regulatory actions associated with a specific NPN. If you’re not already subscribed, this request will automatically subscribe you to the NPN.
get
https://api.sandbox.agentsync.io/v2/entities/{npn}/regulatoryActions
Query Parameters
statesarray[string]
comma separated list of states abbreviations (must be 2 characters) - this will filter on the forState field
Example:MO, CA, CO
updatedSincestring(date)
limits results to those that have an updated date equivalent to or after to the date provided (YYYY-MM-DD) - this will filter on the updatedAt field
Example:2024-10-15
includeDeletedboolean
specifiy whether or not deleted records should be included in the response - this will filter on the niprDeleted field
Default:true
sizeinteger(int64)
the number of objects on the page (min = 1 / max = 1,000)
Default:250
>= 1<= 1000
continuationTokenstring
Token for fetching the next page of results
Path Parameters
npnstringrequired
National Producer Number (npn) of the data to return
Example:123456789
Response
application/hal+json
Response
application/hal+json
Success
embeddedobject
Show Child Parameters
linksobject
Show Child Parameters
application/hal+json
Get regulatory actions by ID
Retrieves a single regulatory actions record using its unique regulatory actions ID.
get
https://api.sandbox.agentsync.io/v1/regulatoryActions/{id}
Path Parameters
idintegerrequired
Unique regulatory actions ID
Response
application/hal+json
Response
application/hal+json
Success
RegulatoryActionsV1
Common regulatory actions fields shared across versions.
idinteger(int64)
Unique identifier for the regulatory actions.
Example:1234567
npnstring
National Producer Number associated with the regulatory actions.
Example:18551108
transactionIdstring(uuid)
Example:ae51f10b-8b5e-40ba-98a9-8f860392b344
forStatestring
State where the regulatory action applies.
>= 2 characters<= 2 characters
Example:AL
actionIdstring
Identification of the regulatory action.
Example:13537078
actionDatestring(date)
The date the regulatory action occurred.
Example:2017-07-10
effectiveDatestring(date)
The date the regulatory action is effective
Example:2017-07-10
enterDatestring(date)
The date the regulatory action was entered in the jurisdiction system.
Example:2018-02-08
fileRefstring
File reference identifier for the regulatory action, as reported by the jurisdiction. Format varies by
state.
Example:123
createdAtstring(date)
Date of the creation of this record in AgentSync.
Example:2021-04-04
updatedAtstring(date)
Date of the most recent update to this record in AgentSync.
Example:2024-12-02
penaltyFineForfeitureinteger
Amount in USD of fine, if applicable.
Example:150
lengthOfOrderinteger
The sanction period.
Example:30
regulatoryActionValuesobject
All regulatory actions should have three associated child objects - disposition, origin, and reason
Show Child Parameters
niprDeletedboolean
Indicates if the regulatory actions was marked deleted by NIPR.
linksobject
Show Child Parameters
application/hal+json
Get regulatory action values by ID
Retrieves a single regulatory action value record using its unique regulatory action value ID.
get
https://api.sandbox.agentsync.io/v1/regulatoryActionValues/{id}
Path Parameters
idintegerrequired
Unique regulatory action value ID
Response
application/hal+json
Response
application/hal+json
Success
RegulatoryActionValuesV1
All regulatory actions should have three associated child objects - disposition, origin, and reason
idinteger
Unique identifier for the regulatory action value.
Example:123
regulatoryActionIdinteger
Unique identifier for the related regulatory action.
Example:1234567
transactionIdstring(uuid)
Example:ae51f10b-8b5e-40ba-98a9-8f860392b344
typestring
One of the following values is expected per object - REASON, ORIGIN, DISPOSITION
Allowed values:REASONORIGINDISPOSITION
Example:DISPOSITION
valuestring
Description of the related regulatory action
Example:Cease And Desist
createdAtstring(date)
Date of the creation of this record in AgentSync.
Example:2021-03-23
updatedAtstring(date)
Date of the most recent update to this record in AgentSync
Example:2024-04-16
metadataobject
Show Child Parameters
deletedboolean
Example:true
application/hal+json
Webhook Events
Outbound events delivered to your configured endpoint when new compliance data is available or your monitored population changes.
producerSyncUpdatesAvailable
WEBHOOKFires once per day, after AgentSync has finished processing NIPR’s refresh
across your entire monitored population.
This is a batch-complete signal, not a per-producer one. There is no event for an
individual NPN, and the payload carries only a runDate — no NPN — because the
event means “every producer you monitor has been processed”, not “this producer
changed”. NIPR publishes once daily, so this is the cadence at which compliance
data can change at all.
Use data.runDate as the value for the updatedSince parameter to fetch just the
records that changed.
post
https://api.sandbox.agentsync.io
Body
application/json
Body
application/json
UpdatesAvailableWebhookEvent
Fields common to every ProducerSync webhook event.
idstringrequired
Unique identifier for this event, a TypeID with the whe_ prefix. Repeated on retries — use it to deduplicate.
Example:whe_01m0a149wzf6sb9ap9y8tafwe1
typestringrequired
The specific event type.
timestampstring(date-time)required
UTC time the event was generated. Fractional-second precision is not fixed - parse with a tolerant RFC 3339 parser rather than a fixed-millisecond format.
Example:2026-08-18T08:52:09.2471298Z
dataobjectrequired
Show Child Parameters
Response
2XX
Response
2XX
Customer endpoint acknowledged the event.
2XX