---
title: "Put Policy"
method: PUT
path: "/patients/{patient_id}/policies/{policy_id}"
tags: ["INSURANCE POLICIES"]
---

# Put Policy

`PUT /patients/{patient_id}/policies/{policy_id}`

## Request

- Base URL: `https://sandbox.elationemr.com/api/2.0`
- URL: `https://sandbox.elationemr.com/api/2.0/patients/{patient_id}/policies/{policy_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/elationhealth/apis/api-authentication/docs/patients/:patient_id/policies/:policy_id/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `patient_id` integer, required
- `policy_id` integer, required

## Request body

- PolicyPutRequestBasic: Request model for updating an insurance policy. Address fields are for the insurance carrier.
  - `address` string, nullable: Carrier street address
  - `carrier_id` integer, nullable: Insurance carrier identifier
  - `carrier_name` string, nullable: Name of the insurance carrier
  - `city` string, nullable: Carrier city
  - `copay` string, nullable: Copay amount
  - `county_code` string, nullable: Carrier county code
  - `deductible` string, nullable: Deductible amount
  - `end_date` string, date, nullable: Policy end date
  - `extension` string, nullable: Carrier phone extension
  - `group_id` string, nullable: Group identifier
  - `id` integer, nullable: Policy ID. If provided, updates the existing policy. If omitted, creates a new policy with a generated ID.
  - `insured_person_address` string, nullable: Insured person's street address
  - `insured_person_city` string, nullable: Insured person's city
  - `insured_person_dob` string, date, nullable: Insured person's date of birth
  - `insured_person_first_name` string, nullable: Insured person's first name
  - `insured_person_id` string, nullable: Insured person's identifier
  - `insured_person_last_name` string, nullable: Insured person's last name
  - `insured_person_sex_at_birth` string, nullable: Insured person's sex at birth
  - `insured_person_ssn` string, nullable: Insured person's SSN
  - `insured_person_state` string, nullable: Insured person's state code
  - `insured_person_zip` string, nullable: Insured person's ZIP code
  - `medicare_secondary_code` string, nullable: Medicare secondary code
  - `member_id` string, nullable: Member identifier
  - `patient_dob` string, date, required: Patient's date of birth
  - `patient_first_name` string, required: Patient's first name
  - `patient_last_name` string, required: Patient's last name
  - `payment_program` 'medicare_part_b' | 'medicare_advantage' | 'medicaid' | 'commercial_hmsa' | 'commercial_sfhp' | 'commercial_other' | 'workers_compensation'
  - `phone` string, nullable: Carrier phone number
  - `plan_id` integer, nullable: Insurance plan identifier
  - `plan_name` string, nullable: Name of the insurance plan
  - `rank` integer, nullable: Policy rank (1=primary, 2=secondary, 3=tertiary)
  - `relationship_to_insured` 'self' | 'child' | 'spouse' | 'other'
  - `start_date` string, date, nullable: Policy start date
  - `state` string, nullable: Carrier state code
  - `status` 'active' | 'inactive'
  - `suite` string, nullable: Carrier suite/unit number
  - `vendor_company_id` integer, nullable: For internal use only
  - `vendor_external_id` string, nullable: For internal use only
  - `zip` string, nullable: Carrier ZIP code

## Response `200`

Successful Response

- PolicyPutRequestBasic: Request model for updating an insurance policy. Address fields are for the insurance carrier.
  - `address` string, nullable: Carrier street address
  - `carrier_id` integer, nullable: Insurance carrier identifier
  - `carrier_name` string, nullable: Name of the insurance carrier
  - `city` string, nullable: Carrier city
  - `copay` string, nullable: Copay amount
  - `county_code` string, nullable: Carrier county code
  - `deductible` string, nullable: Deductible amount
  - `end_date` string, date, nullable: Policy end date
  - `extension` string, nullable: Carrier phone extension
  - `group_id` string, nullable: Group identifier
  - `id` integer, nullable: Policy ID. If provided, updates the existing policy. If omitted, creates a new policy with a generated ID.
  - `insured_person_address` string, nullable: Insured person's street address
  - `insured_person_city` string, nullable: Insured person's city
  - `insured_person_dob` string, date, nullable: Insured person's date of birth
  - `insured_person_first_name` string, nullable: Insured person's first name
  - `insured_person_id` string, nullable: Insured person's identifier
  - `insured_person_last_name` string, nullable: Insured person's last name
  - `insured_person_sex_at_birth` string, nullable: Insured person's sex at birth
  - `insured_person_ssn` string, nullable: Insured person's SSN
  - `insured_person_state` string, nullable: Insured person's state code
  - `insured_person_zip` string, nullable: Insured person's ZIP code
  - `medicare_secondary_code` string, nullable: Medicare secondary code
  - `member_id` string, nullable: Member identifier
  - `patient_dob` string, date, required: Patient's date of birth
  - `patient_first_name` string, required: Patient's first name
  - `patient_last_name` string, required: Patient's last name
  - `payment_program` 'medicare_part_b' | 'medicare_advantage' | 'medicaid' | 'commercial_hmsa' | 'commercial_sfhp' | 'commercial_other' | 'workers_compensation'
  - `phone` string, nullable: Carrier phone number
  - `plan_id` integer, nullable: Insurance plan identifier
  - `plan_name` string, nullable: Name of the insurance plan
  - `rank` integer, nullable: Policy rank (1=primary, 2=secondary, 3=tertiary)
  - `relationship_to_insured` 'self' | 'child' | 'spouse' | 'other'
  - `start_date` string, date, nullable: Policy start date
  - `state` string, nullable: Carrier state code
  - `status` 'active' | 'inactive'
  - `suite` string, nullable: Carrier suite/unit number
  - `vendor_company_id` integer, nullable: For internal use only
  - `vendor_external_id` string, nullable: For internal use only
  - `zip` string, nullable: Carrier ZIP code

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/elationhealth/apis/api-authentication.md) - [All operations](https://skmtc.dev/elationhealth/apis/api-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/elationhealth/apis/api-authentication/revisions/c060f89d4de7?raw)