Unique address ID
Get address by ID
Retrieves a single address record using its unique address ID.
Path Parameters
Response
application/hal+json
Response
Success
AddressV1
Producer Appointments
Appointment information for producers
Get appointments for subscribed NPNs
Returns all appointment records for NPNs you are currently subscribed to.
If no query parameters are provided in the request, then the response will include all appointments
for all currently subscribed NPNs. To maximize effectiveness, we strongly recommend using at least one
parameter to narrow your results.
Query Parameters
comma separated list of National Producer Numbers (NPNs)
Example:123456789, 987654321
comma separated list of states abbreviations (must be 2 characters) - this will filter on the forState field
Example:MO, CA, CO
comma separated list of company/co codes (must by 5 digits) - this will filter on the coCode field
Example:24740,70408,21458
A single appointment status to search for. This is an exact string match of either TERMINATED or APPOINTED - this will filter on the status field
Allowed values:TERMINATEDAPPOINTED
Default:null
Example:TERMINATED
comma seperated list of loa categories - this will filter on the loaMapping.categories array (it will return all records containing at least one of the values passed)
Example:casualty, property
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
Match pattern:yyyy-MM-dd
Example:2024-10-15
specifiy whether or not deleted records should be included in the response - this will filter on the niprDeleted field
Default:true
the number of objects on the page (min = 1 / max = 1,000)
Default:250
>= 1<= 1000
Response
application/hal+json
Response
Success
Show Child Parameters
Get appointments for a specific NPN
Returns all appointments associated with a specific NPN. If you’re not already subscribed, this request will automatically subscribe you to the NPN.
Query Parameters
comma separated list of states abbreviations (must be 2 characters) - this will filter on the forState field
Example:MO, CA, CO
comma separated list of company/co codes (must by 5 digits) - this will filter on the coCode field
Example:24740,70408,21458
A single appointment status to search for. This is an exact string match of either TERMINATED or APPOINTED - this will filter on the status field
Allowed values:TERMINATEDAPPOINTED
Default:null
Example:TERMINATED
comma seperated list of loa categories - this will filter on the loaMapping.categories array (it will return all records containing at least one of the values passed)
Example:casualty, property
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
Match pattern:yyyy-MM-dd
Example:2024-10-15
specifiy whether or not deleted records should be included in the response - this will filter on the niprDeleted field
Default:true
the number of objects on the page (min = 1 / max = 1,000)
Default:250
>= 1<= 1000
Path Parameters
National Producer Number (npn) of the data to return
Example:123456789
Response
application/hal+json
Response
Success
Show Child Parameters
Get appointment by ID
Retrieves a single appointment record using its unique address ID.
Path Parameters
Unique appointment ID
Response
application/hal+json
Response
Success