Policy change

A policy change modifies a policy in between the effective and expiration dates. This transaction type can be used to apply changes to a policy, except for those that involve revising its effective date or the producer of record. For a general overview of how to conduct policy transactions using the system APIs, see Policy transactions. For details on the business functionality of policy changes and other policy transactions in PolicyCenter, see Application Guide.

Change the policy

Initiate a policy change transaction.
Submit a business action POST to the /policy/v1/policies/{policyId}/change endpoint. The request payload must include the job effective date.
```
{
    "data": {
        "attributes": {
            "jobEffectiveDate": "2020-08-18"
        }
    }
}
```
The response payload contains the associated job, which is in Draft state. Use the job ID in subsequent calls.
Modify the job as necessary.
Modifying actions will depend on the LOB and product. For example, in the case of a personal auto line, a caller could add a driver or revise driving percentages of a vehicle.
Sync coverages and modifiers.
To apply coverages, submit a business action POST to the /job/v1/jobs/{jobId}/lines/{lineId}/sync-coverages endpoint. To apply modifiers, submit a business action POST to the /job/v1/jobs/{jobId}/lines/{lineId}/sync-modifiers endpoint.
Generate a quote.
Submit a business action POST to the /job/v1/jobs/{jobId}/quote endpoint.

Complete the policy change transaction.

The following table illustrates the two ways that a quoted policy change job can be completed:


Transaction outcome	Condition	Job status	Endpoint
Accepted	The account holder and insurer agree to the quote, and all necessary paperwork has been received by the insurer. The policy is bound and issued.	Bound	`/job/v1/jobs/{jobId}/bind-and-issue`
Withdrawn	The quote contains erroneous data.	Withdrawn	`/job/v1/jobs/{jobId}/withdrawn`

Submit a business action POST to the relevant endpoint.