On-demand Verification
Verification APIs enable you to perform on-demand producer compliance checks within existing workflows.
The National Producer Number (NPN) is the unique identifier for producers. You can use the producer NPNs to retrieve biographic/firmographic, license and appointment data using our APIs.
Warning
Requests for producer data by their NPN can sometimes trigger downstream calls to regulatory databases which may result in slower API response times. While this will be rare, you can handle timeouts by checking for 5XX
response codes and retrying your call.
Include the https://api.agentsync.io/compliance_check
scope in your OAuth token request in order to use the compliance verification endpoints. Please review Authentication concepts for more details.
Get producer license and appointment data¶
You can retrieve the current license and appointment details for a producer by calling the /v1/entities/:npn/verify
endpoint. Example:
curl --request GET --url 'https://api.sandbox.agentsync.io/v1/entities/10000/verify' \
--header 'Authorization: Bearer <<BEARER\_TOKEN>>
Verify producer against LOA categories, States and/or CoCodes¶
You can verify the license and appointment status for producer against specific LOA categories, states and coCodes /v1/entities/:npn/verify
endpoint and filtering on loaCategories
, states
or coCodes
. Example: