> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morf.health/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Cms1500
> Event payload details and trigger documentation for Cms1500 data from Healthie
# Events
## Triggering Webhook Types
The following event types are associated with the Cms1500 event payload from Healthie.
* `Healthie Cms1500 Created`
* `Healthie Cms1500 Updated`
```json Example theme={null}
{
"accept_assignment": true,
"billing_provider_id": "PROV123",
"client_sig_on_file": true,
"cms1500_policies": [
{
"benefits": [
{
"coinsurance": "15",
"copay": "50",
"deductible_calendar_year": "2000",
"deductible_year_to_date": "1500"
}
],
"effective_end": "2024-07-04",
"group_num": "331256",
"id": "202402",
"insurance_card_back_id": "123452",
"insurance_card_front_id": "123451",
"insurance_plan": {
"id": "611231",
"name_and_id": "Blue Cross Blue Shield - 629913",
"payer_id": "629913",
"payer_name": "Blue Cross Blue Shield"
},
"insurance_type": "Medicaid",
"notes": "Policy is active",
"num": "1912310",
"patient_id": "100121",
"priority_type": "Primary",
"updated_at": "2024-07-01T11:29:19+00:00"
}
],
"cpt_codes_cms1500s": [
{
"cpt_code": "99215",
"description": "New patient office visit, 45-60 minutes",
"display_name": "New patient office visit",
"mod1": "25",
"mod2": "59",
"mod3": "12",
"mod4": "34",
"pointers": "1",
"service_date": "2025-09-22",
"units": "1"
}
],
"dietician_organization_id": "123450",
"dietitian_email_address": "drfleming@example.com",
"dietitian_first_name": "Alexander",
"dietitian_id": "100070",
"dietitian_last_name": "Fleming",
"dietitian_organization_id": "123450",
"icd_codes_cms1500s": [
{
"active": true,
"code": "F41.1",
"created_at": "2024-01-15T10:30:00Z",
"display_name": "Generalized anxiety disorder",
"end_date": "2024-12-31",
"first_symptom_date": "2024-01-10",
"id": "789012",
"updated_at": "2024-01-15T10:30:00Z"
}
],
"id": "57211",
"insured_sig_on_file": true,
"organization_info_id": "ORG789",
"patient": {
"date_of_birth": "1985-03-15",
"location": {
"city": "San Francisco",
"country": "USA",
"line1": "123 Main Street",
"line2": "Suite 100",
"state": "CA",
"zip": "94117"
},
"sex": "Male"
},
"patient_id": "121250",
"referral_info": {
"case_qualifier": "431",
"prior_auth_number": "AUTH123456",
"ref_provider_first": "John",
"ref_provider_last": "Smith",
"ref_provider_qual": "MD"
},
"service_location_id": "LOC456"
}
```
```json Description theme={null}
{
"accept_assignment": "The provider agrees to accept assignment",
"billing_provider_id": "The ID of the Billing Provider",
"client_sig_on_file": "True if the client's signature is on file",
"cms1500_policies": {
"benefits": {
"coinsurance": "Coinsurance percentage due",
"copay": "Copay amount due",
"deductible_calendar_year": "Deductible amount for the calendar year",
"deductible_year_to_date": "Deductible amount for the year to-date"
},
"effective_end": "Date the policy coverage expires",
"group_num": "Group number",
"id": "ID for the policy",
"insurance_card_back_id": "ID of the insurance card back image object",
"insurance_card_front_id": "ID of the insurance card front image object",
"insurance_plan": {
"id": "ID of the insurance plan",
"name_and_id": "Name of the payer and id of payer",
"payer_id": "ID of the insurance payer",
"payer_name": "Name of the insurance payer"
},
"insurance_type": "The type of insurance: `type_string`",
"notes": "Notes about the policy",
"num": "Policy number",
"patient_id": "ID of the patient associated with the policy",
"priority_type": "The priority type of insurance: `priority_type`",
"updated_at": "Last time the Policy was updated"
},
"cpt_codes_cms1500s": {
"cpt_code": "The CPT code",
"description": "The CPT code description",
"display_name": "The CPT display name used in labels",
"mod1": "First modification code",
"mod2": "Second modification code",
"mod3": "Third modification code",
"mod4": "Fourth modification code",
"pointers": "Diagnostic pointers. These are used to connect Diagnosis(ICD) with appropriate Billing Item(CPT) in CMS1500 form",
"service_date": "The service date for the specific code",
"units": "Units for the CPT code"
},
"dietician_organization_id": "Organization ID for the User's (Patient's) registered dietitian",
"dietitian_email_address": "Email address of the User's (Patient's) registered dietitian",
"dietitian_first_name": "First name of the User's (Patient's) registered dietitian",
"dietitian_id": "ID of the User's (Patient's) registered dietitian",
"dietitian_last_name": "Last name of the User's (Patient's) registered dietitian",
"dietitian_organization_id": "Organization ID for the User's (Patient's) registered dietitian",
"icd_codes_cms1500s": {
"active": "Active IcdCodesCms1500",
"code": "The ICD code",
"created_at": "Date created",
"display_name": "Display name for the ICD code",
"end_date": "End date",
"first_symptom_date": "ICD codes in use for this claim",
"id": "The unique identifier of the CMS 1500 ICD code",
"updated_at": "Date updated"
},
"id": "CMS1500 object ID",
"insured_sig_on_file": "True if the insured's signature is on file",
"organization_info_id": "The ID of the Organization Info",
"patient": {
"date_of_birth": "Date of birth of user",
"location": {
"city": "City",
"country": "Country",
"line1": "First line of the address",
"line2": "Second line of the address",
"state": "State",
"zip": "Zip code"
},
"sex": "Sex of the user (Stated on ID card for insurance purposes)"
},
"patient_id": "Patient's ID",
"referral_info": {
"case_qualifier": "The qualifier for case_date",
"prior_auth_number": "The prior authorization number",
"ref_provider_first": "The first name of the referring provider",
"ref_provider_last": "The last name of the referring provider",
"ref_provider_qual": "The qualifications of the referring provider"
},
"service_location_id": "The ID of the service location"
}
```
### Payload Field Details
CMS1500 object ID
```json CEL theme={null}
id
```
```json Example theme={null}
"57211"
```
`ID` Patient's ID
```json CEL theme={null}
patient_id
```
```json Example theme={null}
"121250"
```
Organization ID for the User's (Patient's) registered dietitian
```json CEL theme={null}
dietician_organization_id
```
```json Example theme={null}
"123450"
```
Organization ID for the User's (Patient's) registered dietitian
```json CEL theme={null}
dietitian_organization_id
```
```json Example theme={null}
"123450"
```
First name of the User's (Patient's) registered dietitian
```json CEL theme={null}
dietitian_first_name
```
```json Example theme={null}
"Alexander"
```
Last name of the User's (Patient's) registered dietitian
```json CEL theme={null}
dietitian_last_name
```
```json Example theme={null}
"Fleming"
```
Email address of the User's (Patient's) registered dietitian
```json CEL theme={null}
dietitian_email_address
```
```json Example theme={null}
"drfleming@example.com"
```
ID of the User's (Patient's) registered dietitian
```json CEL theme={null}
dietitian_id
```
```json Example theme={null}
"100070"
```
The ID of the Billing Provider
```json CEL theme={null}
billing_provider_id
```
```json Example theme={null}
"PROV123"
```
The referral info for the CMS1500
```json CEL theme={null}
referral_info
```
```json Example theme={null}
{
"case_qualifier": "431",
"prior_auth_number": "AUTH123456",
"ref_provider_first": "John",
"ref_provider_last": "Smith",
"ref_provider_qual": "MD"
}
```
The qualifications of the referring provider
```json CEL theme={null}
referral_info.ref_provider_qual
```
```json Example theme={null}
"MD"
```
The first name of the referring provider
```json CEL theme={null}
referral_info.ref_provider_first
```
```json Example theme={null}
"John"
```
The last name of the referring provider
```json CEL theme={null}
referral_info.ref_provider_last
```
```json Example theme={null}
"Smith"
```
The qualifier for case\_date
```json CEL theme={null}
referral_info.case_qualifier
```
```json Example theme={null}
"431"
```
The prior authorization number
```json CEL theme={null}
referral_info.prior_auth_number
```
```json Example theme={null}
"AUTH123456"
```
The ID of the service location
```json CEL theme={null}
service_location_id
```
```json Example theme={null}
"LOC456"
```
The ID of the Organization Info
```json CEL theme={null}
organization_info_id
```
```json Example theme={null}
"ORG789"
```
Policies in use for this claim
```json CEL theme={null}
cms1500_policies
```
```json Example theme={null}
[
{
"benefits": [
{
"coinsurance": "15",
"copay": "50",
"deductible_calendar_year": "2000",
"deductible_year_to_date": "1500"
}
],
"effective_end": "2024-07-04",
"group_num": "331256",
"id": "202402",
"insurance_card_back_id": "123452",
"insurance_card_front_id": "123451",
"insurance_plan": {
"id": "611231",
"name_and_id": "Blue Cross Blue Shield - 629913",
"payer_id": "629913",
"payer_name": "Blue Cross Blue Shield"
},
"insurance_type": "Medicaid",
"notes": "Policy is active",
"num": "1912310",
"patient_id": "100121",
"priority_type": "Primary",
"updated_at": "2024-07-01T11:29:19+00:00"
}
]
```
Mapped array of: Insurance plan details
```json CEL theme={null}
cms1500_policies.map(x, x.insurance_plan)
```
```json Example theme={null}
[
{
"id": "611231",
"name_and_id": "Blue Cross Blue Shield - 629913",
"payer_id": "629913",
"payer_name": "Blue Cross Blue Shield"
}
]
```
`PII` Mapped array of: Policy number
```json CEL theme={null}
cms1500_policies.map(x, x.num)
```
```json Example theme={null}
[
"1912310"
]
```
Mapped array of: Group number
```json CEL theme={null}
cms1500_policies.map(x, x.group_num)
```
```json Example theme={null}
[
"331256"
]
```
Mapped array of: Notes about the policy
```json CEL theme={null}
cms1500_policies.map(x, x.notes)
```
```json Example theme={null}
[
"Policy is active"
]
```
Mapped array of: Date the policy coverage expires
```json CEL theme={null}
cms1500_policies.map(x, x.effective_end)
```
```json Example theme={null}
[
"2024-07-04"
]
```
Mapped array of: ID for the policy
```json CEL theme={null}
cms1500_policies.map(x, x.id)
```
```json Example theme={null}
[
"202402"
]
```
`ID` `PII` Mapped array of: ID of the patient associated with the policy
```json CEL theme={null}
cms1500_policies.map(x, x.patient_id)
```
```json Example theme={null}
[
"100121"
]
```
`HI` `ID` `PII` Mapped array of: ID of the insurance card front image object
```json CEL theme={null}
cms1500_policies.map(x, x.insurance_card_front_id)
```
```json Example theme={null}
[
"123451"
]
```
`HI` `ID` `PII` Mapped array of: ID of the insurance card back image object
```json CEL theme={null}
cms1500_policies.map(x, x.insurance_card_back_id)
```
```json Example theme={null}
[
"123452"
]
```
Mapped array of: Last time the Policy was updated
```json CEL theme={null}
cms1500_policies.map(x, x.updated_at)
```
```json Example theme={null}
[
"2024-07-01T11:29:19+00:00"
]
```
Mapped array of: The type of insurance: `type_string`
```json CEL theme={null}
cms1500_policies.map(x, x.insurance_type)
```
```json Example theme={null}
[
"Medicaid"
]
```
Mapped array of: The priority type of insurance: `priority_type`
```json CEL theme={null}
cms1500_policies.map(x, x.priority_type)
```
```json Example theme={null}
[
"Primary"
]
```
Mapped array of: Insurance plan details
```json CEL theme={null}
cms1500_policies.map(x, x.benefits)
```
```json Example theme={null}
[
[
{
"coinsurance": "15",
"copay": "50",
"deductible_calendar_year": "2000",
"deductible_year_to_date": "1500"
}
]
]
```
True if the client's signature is on file
```json CEL theme={null}
client_sig_on_file
```
```json Example theme={null}
true
```
True if the insured's signature is on file
```json CEL theme={null}
insured_sig_on_file
```
```json Example theme={null}
true
```
The provider agrees to accept assignment
```json CEL theme={null}
accept_assignment
```
```json Example theme={null}
true
```
ICD codes in use for this claim
```json CEL theme={null}
icd_codes_cms1500s
```
```json Example theme={null}
[
{
"active": true,
"code": "F41.1",
"created_at": "2024-01-15T10:30:00Z",
"display_name": "Generalized anxiety disorder",
"end_date": "2024-12-31",
"first_symptom_date": "2024-01-10",
"id": "789012",
"updated_at": "2024-01-15T10:30:00Z"
}
]
```
Mapped array of: The unique identifier of the CMS 1500 ICD code
```json CEL theme={null}
icd_codes_cms1500s.map(x, x.id)
```
```json Example theme={null}
[
"789012"
]
```
Mapped array of: Active IcdCodesCms1500
```json CEL theme={null}
icd_codes_cms1500s.map(x, x.active)
```
```json Example theme={null}
[
true
]
```
Mapped array of: Display name for the ICD code
```json CEL theme={null}
icd_codes_cms1500s.map(x, x.display_name)
```
```json Example theme={null}
[
"Generalized anxiety disorder"
]
```
Mapped array of: Date created
```json CEL theme={null}
icd_codes_cms1500s.map(x, x.created_at)
```
```json Example theme={null}
[
"2024-01-15T10:30:00Z"
]
```
Mapped array of: Date updated
```json CEL theme={null}
icd_codes_cms1500s.map(x, x.updated_at)
```
```json Example theme={null}
[
"2024-01-15T10:30:00Z"
]
```
Mapped array of: End date
```json CEL theme={null}
icd_codes_cms1500s.map(x, x.end_date)
```
```json Example theme={null}
[
"2024-12-31"
]
```
Mapped array of: ICD codes in use for this claim
```json CEL theme={null}
icd_codes_cms1500s.map(x, x.first_symptom_date)
```
```json Example theme={null}
[
"2024-01-10"
]
```
Mapped array of: The ICD code
```json CEL theme={null}
icd_codes_cms1500s.map(x, x.code)
```
```json Example theme={null}
[
"F41.1"
]
```
CPT codes in use for this claim
```json CEL theme={null}
cpt_codes_cms1500s
```
```json Example theme={null}
[
{
"cpt_code": "99215",
"description": "New patient office visit, 45-60 minutes",
"display_name": "New patient office visit",
"mod1": "25",
"mod2": "59",
"mod3": "12",
"mod4": "34",
"pointers": "1",
"service_date": "2025-09-22",
"units": "1"
}
]
```
Mapped array of: Units for the CPT code
```json CEL theme={null}
cpt_codes_cms1500s.map(x, x.units)
```
```json Example theme={null}
[
"1"
]
```
Mapped array of: First modification code
```json CEL theme={null}
cpt_codes_cms1500s.map(x, x.mod1)
```
```json Example theme={null}
[
"25"
]
```
Mapped array of: Second modification code
```json CEL theme={null}
cpt_codes_cms1500s.map(x, x.mod2)
```
```json Example theme={null}
[
"59"
]
```
Mapped array of: Third modification code
```json CEL theme={null}
cpt_codes_cms1500s.map(x, x.mod3)
```
```json Example theme={null}
[
"12"
]
```
Mapped array of: Fourth modification code
```json CEL theme={null}
cpt_codes_cms1500s.map(x, x.mod4)
```
```json Example theme={null}
[
"34"
]
```
Mapped array of: Diagnostic pointers. These are used to connect Diagnosis(ICD) with appropriate Billing Item(CPT) in CMS1500 form
```json CEL theme={null}
cpt_codes_cms1500s.map(x, x.pointers)
```
```json Example theme={null}
[
"1"
]
```
Mapped array of: The CPT code
```json CEL theme={null}
cpt_codes_cms1500s.map(x, x.cpt_code)
```
```json Example theme={null}
[
"99215"
]
```
Mapped array of: The CPT display name used in labels
```json CEL theme={null}
cpt_codes_cms1500s.map(x, x.display_name)
```
```json Example theme={null}
[
"New patient office visit"
]
```
Mapped array of: The CPT code description
```json CEL theme={null}
cpt_codes_cms1500s.map(x, x.description)
```
```json Example theme={null}
[
"New patient office visit, 45-60 minutes"
]
```
Mapped array of: The service date for the specific code
```json CEL theme={null}
cpt_codes_cms1500s.map(x, x.service_date)
```
```json Example theme={null}
[
"2025-09-22"
]
```
The patient for the CMS1500
```json CEL theme={null}
patient
```
```json Example theme={null}
{
"date_of_birth": "1985-03-15",
"location": {
"city": "San Francisco",
"country": "USA",
"line1": "123 Main Street",
"line2": "Suite 100",
"state": "CA",
"zip": "94117"
},
"sex": "Male"
}
```
Date of birth of user
```json CEL theme={null}
patient.date_of_birth
```
```json Example theme={null}
"1985-03-15"
```
Sex of the user (Stated on ID card for insurance purposes)
```json CEL theme={null}
patient.sex
```
```json Example theme={null}
"Male"
```
The address of this user
```json CEL theme={null}
patient.location
```
```json Example theme={null}
{
"city": "San Francisco",
"country": "USA",
"line1": "123 Main Street",
"line2": "Suite 100",
"state": "CA",
"zip": "94117"
}
```
First line of the address
```json CEL theme={null}
patient.location.line1
```
```json Example theme={null}
"123 Main Street"
```
Second line of the address
```json CEL theme={null}
patient.location.line2
```
```json Example theme={null}
"Suite 100"
```
City
```json CEL theme={null}
patient.location.city
```
```json Example theme={null}
"San Francisco"
```
State
```json CEL theme={null}
patient.location.state
```
```json Example theme={null}
"CA"
```
Zip code
```json CEL theme={null}
patient.location.zip
```
```json Example theme={null}
"94117"
```
Country
```json CEL theme={null}
patient.location.country
```
```json Example theme={null}
"USA"
```