Skip to content

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:

curl --request GET --url '<https://api.sandbox.agentsync.io/v1/entities/10000/verify?states=CA>,CO&coCodes=1234,2345&loaCategories=property,health' \
  --header 'Authorization: Bearer <<BEARER\_TOKEN>>