Create Policy Reinstatement Endorsement

post

https://{environment}.origamirisk.com/OrigamiApi/api/Policies/{policyID}/Reinstate

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Overview

Creates a reinstatement endorsement for a previously cancelled policy. Like the Cancel endpoint, this does not immediately reinstate the policy — it creates an endorsement proposal representing the reinstatement, applies it as a policy change, and rates the endorsement. The returned RecordID is the new endorsement's ProposalID.

What this endpoint does:

Loads the policy by policyID
Validates the policy can be reinstated (must be cancelled, dates must be valid)
Defaults reinstateDate to the last cancellation date if not provided
Creates a PolicyChange record with action Reinstate
Populates the policy transaction from the request body (reinstatement reason, description, etc.)
Creates a reinstatement endorsement proposal via CreateEndorsement
Accepts the policy change against the endorsement and rates it
Returns the new endorsement's ProposalID

Path Params

policyID

integer

required

The ID of the cancelled policy to reinstate.

Query Params

reinstateDate

string

required

Effective date for reinstatement. If you want to reinstate as of the original cancellation date, set this value to null. Use ISO 8601 format: (YYYY-MM-DD).

Body Params

RAW_BODY

json

required

Defaults to {}

The request body is a JSON representation of the PolicyTransaction dataDictionary.

See the API reference for api/MetaData/Domains/{domain}/DataDictionary where PolicyTransaction is the {domain} value.

If a key is unrecognized, the API throws InvalidOperationException("Unknown field: {key}").

For reinstatements, the most relevant fields are:

Field	Type	Description
`ReinstatementReasonID`	int	ID of the reinstatement reason code. Use the `Codes/ReinstatementReasonCodes` endpoint to retrieve valid values.
`Description`	string (max 250)	Notes or description for the reinstatement transaction

POST /api/Policies/12345/Reinstate
Content-Type: application/json

{
  "ReinstatementReasonID": 3,
  "Description": "Insured resumed premium payments"
}

Reinstate on a specific date:

POST /api/Policies/12345/Reinstate?reinstateDate=2026-07-01
Content-Type: application/json

{
  "ReinstatementReasonID": 1
}

Minimal request (no transaction data, default date):

POST /api/Policies/12345/Reinstate
Content-Type: application/json

null

Response

Overview

200