Updates an existing patient policy.

put

https://integrationhub.wellsky.io/commands/v4/patients/policies/{patientPolicyId}

Sample request:

PUT /commands/v4/patients/policies/12345
{
    "carrierId": 100,
    "policyNumber": "POL123456-UPDATED",
    "sequence": 2,
    "status": "Inactive"
}

Notes:

All fields are optional; only provided fields will be updated
MedicalRecordNumber cannot be changed
If Sequence is changed, other policies for the patient will be reordered

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

patientPolicyId

int64

required

Defaults to null

The unique identifier of the patient policy to update.

Query Params

api-version

string

The requested API version

Body Params

The updated patient policy information.

Request model for updating an existing patient policy.

carrierId

int64 | null

≥ 1

Unique identifier of the carrier (insurance company).

policyOwnerId

int64 | null

≥ 1

Unique identifier of the policy owner.

policyContactId

int64 | null

≥ 1

Unique identifier of the policy contact.

employerId

int64 | null

≥ 1

Unique identifier of the employer.

policyNumber

string | null

Policy number.

groupNumber

string | null

Group number.

insuredId

string | null

Insured ID number.

planName

string | null

Plan name of the patient policy.

planId

string | null

Plan ID of the patient policy.

effectiveDate

date-time | null

Effective date of the patient policy.

expirationDate

date-time | null

Expiration date of the patient policy.

sequence

int32 | null

1 to 2147483647

Policy sequence number. If changed, other policies for the patient will be reordered.

patientRelationToInsured

string | null

Patient relation to insured (e.g., Self, Spouse, Child).

insuranceProgram

string | null

Insurance program name (e.g., MEDICARE, MEDICAID).

carrierBINPCNId

int64 | null

≥ 1

Unique identifier of the carrier BIN/PCN.

nextPayerId

int64 | null

≥ 1

Unique identifier of the next payer (for secondary coverage).

isBillForDenial

boolean | null

Bill for denial flag.

medicaidNumber

string | null

Medicaid number.

submissionClarificationCode

string | null

Submission clarification code (01-10).

personCode

string | null

Person code.

isResidesInCMSPartDFacility

boolean | null

Resides in CMS Part D facility flag.

dateOfInjury

date-time | null

Date of injury.

onsetDate

date-time | null

Onset date.

causeOfInjury

string | null

Cause of injury (e.g., AutoAccident, WorkInjury).

causeOfInjuryState

string | null

Cause of injury state code.

claimCode

string | null

Claim code.

unableToWorkStart

date-time | null

Unable to work start date.

unableToWorkEnd

date-time | null

Unable to work end date.

isMedicalSecondaryToMedicare

boolean | null

Medical secondary to medicare flag.

propertyCasualtyClaimNumber

string | null

Property casualty claim number.

mspTypeCode

string | null

Medicare secondary provider type code.

signatureSource

string | null

Signature source code.

releaseOfInfoCode

string | null

Release of information code.

papPatientResponsibility

double | null

≥ 0

PAP patient responsibility amount.

papStatus

string | null

PAP status (e.g., Pending, Approved, Inactive, Denied).

papHouseholdIncome

double | null

≥ 0

PAP household income amount.

papNumberOfDependents

int32 | null

0 to 2147483647

PAP number of dependents.

status

string | null

Status of policy (Active or Inactive).

patientFirstName

string | null

Patient first name on policy.

patientLastName

string | null

Patient last name on policy.

Headers

content-type

string

enum

Defaults to application/json-patch+json

Generated from available request content types

Allowed:

Responses

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Bad Request

404Not Found

500Internal Server Error