History events
When certain events occur in InsuranceSuite they are automatically recorded.
Each history event is stored as a CustomHistory type. You can retrieve these history
events by using the history-events
endpoint.
The following endpoints are available for retrieving history events:
- GET
/common/v1/history-events/{historyEventId}
- GET
/account/v1/accounts/{accountId}/history-events
- GET
/policy/v1/policies/{policyId}/history-events
- GET
/job/v1/jobs/{jobId}/history-events
- GET
/common/v1/contacts/{contactId}/history-events
The following sections provide examples of these endpoints.
Retrieve a single history event
You can retrieve a single history event by using the
history-events
endpoint in the common API. To use this endpoint
you must first retrieve the historyEventId
from the
history-events
endpoint on the relevant object, such as the
contacts object in the ContactManager Contact API. (For more information on the
Contact API, see History events for
ContactManager.)
The information retrieved in this example is from an account change history event where the account changed from pending to active.
Command
Response
Retrieve account history events
Account events include history events that occur on policies and jobs on the account, as well as on the account itself. In the following example, the response contains history events for the creation of a new policy submission and a status change on the account.
Command
Response
Retrieve policy history events
Policy events include history events that occur on a policy such as submission and renewal. The following example retrieves the history events for a policy, which includes issuing and binding a policy submission.
Command
Response
Retrieve contact history events
There is an endpoint for retrieving contact history events, but in the base configuration, there are no history events that are recorded for contacts. History events must be configured manually to be recorded.
In the following example, the history events for contact ab:110 includes the creation of the contact and an update to the contact's primary address. These are both custom history events that were added to PolicyCenter.
Retrieve job history events
Job events include history events that occur on a specific job, such as submission and binding. The following example retrieves the history events on a job.
Command
Response