---
title: "Changes to Create institutional or professional encounter"
method: POST
path: "/api/encounters/v4/universal"
---

# Changes to Create institutional or professional encounter

`POST /api/encounters/v4/universal`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 15 revisions.

- **2026-10-29** `d8b0a61873e2`: 2 info
- **2026-10-15** `97de8fddb088`: 1 warning, 1 info
- **2026-10-02** `7fd881bab7b6`: 2 warning, 3 info
- **2026-09-24** `4074901c170f`: 2 info
- **2026-09-22** `5f44e6b56da6`: 2 info
- **2026-09-17** `24b2d80d577a`: 95 breaking, 1 warning, 300 info
- **2026-09-12** `3a81ee81d4ed`: 1 info
- **2026-09-01** `1ae110d4149b`: 7 info
- **2026-08-26** `293f25b8a5c7`: 3 info
- **2026-08-22** `7cc5974e4128`: 1 info

## Changes

- **2026-10-29** `d8b0a61873e2`: 2 info
  - added the new optional request property `service_lines/items/rendering_provider`
  - added the optional property `claims/items/service_lines/items/rendering_provider` to the response with the `200` status
- **2026-10-15** `97de8fddb088`: 1 warning, 1 info
  - added the new `RT` enum value to the `treating_provider/license_type` response property for the response status `200`
  - added the new `RT` enum value to the request property `treating_provider/license_type`
- **2026-10-02** `7fd881bab7b6`: 2 warning, 3 info
  - added the new `WC` enum value to the `claims/items/service_lines/items/modifiers/items/` response property for the response status `200`
  - added the new `WH` enum value to the `claims/items/service_lines/items/modifiers/items/` response property for the response status `200`
  - request property `referring_provider/qualifier` deprecated
  - added the new `WC` enum value to the request property `service_lines/items/modifiers/items/`
  - added the new `WH` enum value to the request property `service_lines/items/modifiers/items/`
- **2026-09-24** `4074901c170f`: 2 info
  - added the new optional request property `initial_treatment_date`
  - added the optional property `initial_treatment_date` to the response with the `200` status
- **2026-09-22** `5f44e6b56da6`: 2 info
  - added the new optional request property `referring_provider/qualifier`
  - added the optional property `claims/items/service_lines/items/custom_procedure_code` to the response with the `200` status
- **2026-09-17** `24b2d80d577a`: 95 breaking, 1 warning, 300 info
  - added the new required request property `attending_provider/npi`
  - added the new required request property `billing_notes/items/text`
  - added the new required request property `billing_provider/address`
  - added the new required request property `billing_provider/npi`
  - added the new required request property `billing_provider/tax_id`
  - added the new required request property `claim_supplemental_information/items/attachment_report_type_code`
  - added the new required request property `claim_supplemental_information/items/attachment_transmission_code`
  - added the new required request property `clinical_notes/items/category`
  - added the new required request property `clinical_notes/items/notes`
  - added the new required request property `epsdt_referral/condition_indicator1`
  - added the new required request property `existing_medications/items/name`
  - added the new required request property `external_claim_submission/claim_created_at`
  - added the new required request property `external_claim_submission/patient_control_number`
  - added the new required request property `external_claim_submission/submission_records`
  - added the new required request property `guarantor/address`
  - added the new required request property `guarantor/external_id`
  - added the new required request property `guarantor/first_name`
  - added the new required request property `guarantor/last_name`
  - added the new required request property `initial_referring_provider/npi`
  - added the new required request property `interventions/items/category`
  - added the new required request property `interventions/items/name`
  - added the new required request property `operating_provider/npi`
  - added the new required request property `other_operating_provider/npi`
  - added the new required request property `patient_histories/items/category`
  - added the new required request property `patient_histories/items/questions`
  - added the new required request property `property_casualty_patient_identifier/property_casualty_patient_identifier`
  - added the new required request property `property_casualty_patient_identifier/property_casualty_patient_identifier_qualifier`
  - added the new required request property `referring_provider/npi`
  - added the new required request property `related_causes_information/related_causes_code_1`
  - added the new required request property `rendering_provider/npi`
  - added the new required request property `schema_instances/items/content`
  - added the new required request property `schema_instances/items/schema_id`
  - added the new required request property `service_lines/items/quantity`
  - added the new required request property `service_lines/items/units`
  - added the new required request property `subscriber_primary/insurance_card/member_id`
  - added the new required request property `subscriber_primary/insurance_card/payer_id`
  - added the new required request property `subscriber_primary/insurance_card/payer_name`
  - added the new required request property `subscriber_secondary/insurance_card/member_id`
  - added the new required request property `subscriber_secondary/insurance_card/payer_id`
  - added the new required request property `subscriber_secondary/insurance_card/payer_name`
  - …356 more
- **2026-09-12** `3a81ee81d4ed`: 1 info
  - api operation id `create-universal` removed and replaced with `v4_create-universal`
- **2026-09-01** `1ae110d4149b`: 7 info
  - added the new `FC` enum value to the request property `accident_state_or_province_code`
  - added the new `FC` enum value to the request property `patient/address/state`
  - added the new `FC` enum value to the request property `pay_to_address/state`
  - added the new `FC` enum value to the request property `service_facility/address/state`
  - added the new `FC` enum value to the request property `subscriber_primary/address/state`
  - added the new `FC` enum value to the request property `subscriber_secondary/address/state`
  - added the new `FC` enum value to the request property `subscriber_tertiary/address/state`
- **2026-08-26** `293f25b8a5c7`: 3 info
  - added the new optional request property `outside_lab`
  - added the new optional request property `outside_lab_charges_amount_cents`
  - added the new optional request property `purchased_service_provider_npi`
- **2026-08-22** `7cc5974e4128`: 1 info
  - request property `patient/non_insurance_payers` deprecated

---

[Operation](https://skmtc.dev/joincandidhealth/apis/api-reference/docs/api/encounters/v4/universal/post.md) - [API](https://skmtc.dev/joincandidhealth/apis/api-reference.md) - [Page](https://skmtc.dev/joincandidhealth/apis/api-reference/changes/api/encounters/v4/universal/post)
