Reinstatements

Reinstatements are initiated from the policy itself. Reinstatements can be initiated only from canceled policies.

Use the following endpoint to create a reinstatement for a given canceled policy:

• POST /policy/v1/policies/{policyId}/reinstate

You must specify the following fields:

• reinstateCode: A typecode from the ReinstateCode typelist

For example, the following initiates a reinstatement for policy pc:44.

POST /policy/v1/policies/pc:44/reinstate
            

{
  "data": {
    "attributes": {
      "reinstateCode": {
        "code": "payment"
      }
    }
  }
}

This call creates a new job instance whose job type is "Reinstatement". The job's state is Draft. The reinstatement's jobEffectiveDate is automatically set to the job effective date of the corresponding cancellation.

Typically, a policy is not modified when it is reinstated. The most common intent of a reinstatement is to reinstate the policy in the state it was in when it was canceled.

However, it is necessary to quote the reinstatement. This is because additional charges may have been added as a result of the reinstatement, such as a reinstatement fee. To quote the reinstatement, use the POST /job/v1/jobs/{jobId}/quote endpoint. The request object does not require a request body.

POST /job/v1/jobs/pc:4040/quote
                
<no request body>

The following table summarizes the different endpoints that can be used to complete a reinstatement.

POST /job/v1/jobs/pc:333/bind-and-issue
                
<no request body>

POST /job/v1/jobs/pc:333/withdraw
                
<no request body>