Create Claim From Healthie CMS 1500

POST

api

claim

healthie

cURL

curl --request POST \
  --url https://forecaster.cairhealth.com/api/claim/healthie/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "12345",
  "date_of_service": "2025-03-15",
  "total_charge": "250.00",
  "patient": {
    "id": "P98765",
    "first_name": "John",
    "last_name": "Doe",
    "name": "John Doe",
    "gender": "male",
    "dob": "1980-05-15",
    "location": {
      "city": "San Francisco",
      "country": "USA",
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "state": "CA",
      "zip": "94105"
    },
    "policies": [
      {
        "id": "POL123",
        "group_num": "GRP456",
        "name": "Premium Health Plan",
        "holder_first": "John",
        "holder_last": "Doe",
        "holder_relationship": "self",
        "insurance_plan": {
          "payer_name": "Blue Cross",
          "payer_id": "BCBS123",
          "name_and_id": "Blue Cross (BCBS123)"
        }
      }
    ]
  },
  "billing_provider": {
    "name": "Medical Group Inc",
    "npi": "1234567890",
    "tax_id": "12-3456789",
    "location": {
      "city": "San Francisco",
      "country": "USA",
      "line1": "456 Health Ave",
      "state": "CA",
      "zip": "94107"
    }
  },
  "rendering_provider": {
    "id": "DR12345",
    "first_name": "Jane",
    "last_name": "Smith",
    "npi": "5432167890",
    "name": "Jane Smith, MD"
  },
  "cpt_codes_cms1500s": [
    {
      "cpt_code": {
        "code": "99213"
      }
    },
    {
      "cpt_code": {
        "code": "85025"
      }
    }
  ],
  "icd_codes_cms1500s": [
    {
      "icd_code": {
        "code": "J20.9"
      }
    },
    {
      "icd_code": {
        "code": "R50.9"
      }
    }
  ]
}
'

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "information",
      "code": "informational",
      "diagnostics": "Claim created successfully"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

attachmentId

string

Optional ID of document references to associate with the claim. Can be specified multiple times. This id will be returned from the Create Claim Attachment endpoint.

Body

application/json

Healthie CMS 1500 claim data

string

required

Unique identifier for the CMS 1500 form

date_of_service

string

required

Date when the service was provided

total_charge

string

required

Total charge amount for the claim

patient

object

required

Information about the patient

Show child attributes

patient.id

string

Patient identifier

patient.first_name

string

Patient's first name

patient.last_name

string

Patient's last name

patient.name

string

Patient's full name

patient.gender

string

Patient's gender

patient.dob

string

Patient's date of birth

patient.location

object

Patient's address information

Show child attributes

patient.location.city

string

City

patient.location.country

string

Country

patient.location.line1

string

Address line 1

patient.location.line2

string

Address line 2

patient.location.name

string

Location name

patient.location.state

string

State

patient.location.to_oneline

string

Single line address representation

patient.location.zip

string

ZIP/Postal code

patient.policies

object[]

Patient's insurance policies

Show child attributes

patient.policies.id

string

Policy identifier

patient.policies.num

string

Policy number

patient.policies.group_num

string

Insurance group number

patient.policies.name

string

Policy name

patient.policies.holder_first

string

Policy holder's first name

patient.policies.holder_last

string

Policy holder's last name

patient.policies.holder_relationship

string

Relationship between patient and policy holder

patient.policies.insurance_plan

object

Insurance plan details

Show child attributes

patient.policies.insurance_plan.payer_name

string

required

Name of the insurance payer

patient.policies.insurance_plan.payer_id

string

required

Identifier for the insurance payer

patient.policies.insurance_plan.name_and_id

string

Combined name and ID of the insurance plan

billing_provider

object

required

Information about the billing provider

Show child attributes

billing_provider.name

string

required

Provider name

billing_provider.npi

string

required

National Provider Identifier

billing_provider.tax_id

string

required

Provider tax ID

billing_provider.location

object

required

Provider's address information

Show child attributes

billing_provider.location.city

string

City

billing_provider.location.country

string

Country

billing_provider.location.line1

string

Address line 1

billing_provider.location.line2

string

Address line 2

billing_provider.location.name

string

Location name

billing_provider.location.state

string

State

billing_provider.location.to_oneline

string

Single line address representation

billing_provider.location.zip

string

ZIP/Postal code

rendering_provider

object

required

Information about the rendering provider

Show child attributes

rendering_provider.npi

string

required

Provider's NPI

rendering_provider.id

string

Provider identifier

rendering_provider.first_name

string

Provider's first name

rendering_provider.last_name

string

Provider's last name

rendering_provider.name

string

Provider's full name

rendering_provider.gender

string

Provider's gender

rendering_provider.dob

string

Provider's date of birth

rendering_provider.location

object

Provider's address information

Show child attributes

rendering_provider.location.city

string

City

rendering_provider.location.country

string

Country

rendering_provider.location.line1

string

Address line 1

rendering_provider.location.line2

string

Address line 2

rendering_provider.location.name

string

Location name

rendering_provider.location.state

string

State

rendering_provider.location.to_oneline

string

Single line address representation

rendering_provider.location.zip

string

ZIP/Postal code

cpt_codes_cms1500s

object[]

required

CPT codes associated with the claim

Show child attributes

cpt_codes_cms1500s.cpt_code

object

required

Show child attributes

cpt_codes_cms1500s.cpt_code.code

string

required

CPT code value

cpt_codes_cms1500s.fee

string

Billed amount for this service

cpt_codes_cms1500s.units

string

Number of units for this service

cpt_codes_cms1500s.mod1

string

Modifier 1

cpt_codes_cms1500s.mod2

string

Modifier 2

cpt_codes_cms1500s.mod3

string

Modifier 3

cpt_codes_cms1500s.mod4

string

Modifier 4

icd_codes_cms1500s

object[]

required

ICD diagnosis codes associated with the claim

Show child attributes

icd_codes_cms1500s.icd_code

object

required

Show child attributes

icd_codes_cms1500s.icd_code.code

string

required

ICD code value

service_location

object

Location of the service

Show child attributes

service_location.place_of_service

object

Place of service details

Show child attributes

service_location.place_of_service.code

string

Code of the place of service

service_location.place_of_service.name

string

Name of the place of service

service_location.place_of_service.code_name

string

Code name of the place of service

Response

Claim created successfully

A FHIR standard response format for operations

resourceType

enum<string>

required

Type of resource

Available options:

OperationOutcome

issue

object[]

required

A list of issues with the operation

Show child attributes

issue.severity

enum<string>

required

Severity of the issue

Available options:

fatal,

error,

warning,

information

issue.code

enum<string>

required

Error or warning code

Available options:

invalid,

structure,

required,

value,

invariant,

security,

login,

unknown,

expired,

forbidden,

suppressed,

processing,

not-supported,

duplicate,

multiple-matches,

not-found,

deleted,

too-long,

code-invalid,

extension,

too-costly,

business-rule,

conflict,

transient,

lock-error,

no-store,

exception,

timeout,

incomplete,

throttled,

informational

issue.diagnostics

string

Additional diagnostic information about the issue

issue.details

object

Show child attributes

issue.details.text

string

Text description of the issue

issue.details.coding

object[]

Coding of the issue

issue.location

string[]

Locations in the resource where the issue occurred

issue.expression

string[]

FHIRPath of element(s) causing the issue

string

Logical id of this artifact

Create Professional ClaimCreates a professional claim from a CMS 1500 file. This schema is an augmentation of the Healthie CMS 1500 schema to support the full CMS-1500 claim format.

⌘I

cURL

curl --request POST \
  --url https://forecaster.cairhealth.com/api/claim/healthie/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "12345",
  "date_of_service": "2025-03-15",
  "total_charge": "250.00",
  "patient": {
    "id": "P98765",
    "first_name": "John",
    "last_name": "Doe",
    "name": "John Doe",
    "gender": "male",
    "dob": "1980-05-15",
    "location": {
      "city": "San Francisco",
      "country": "USA",
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "state": "CA",
      "zip": "94105"
    },
    "policies": [
      {
        "id": "POL123",
        "group_num": "GRP456",
        "name": "Premium Health Plan",
        "holder_first": "John",
        "holder_last": "Doe",
        "holder_relationship": "self",
        "insurance_plan": {
          "payer_name": "Blue Cross",
          "payer_id": "BCBS123",
          "name_and_id": "Blue Cross (BCBS123)"
        }
      }
    ]
  },
  "billing_provider": {
    "name": "Medical Group Inc",
    "npi": "1234567890",
    "tax_id": "12-3456789",
    "location": {
      "city": "San Francisco",
      "country": "USA",
      "line1": "456 Health Ave",
      "state": "CA",
      "zip": "94107"
    }
  },
  "rendering_provider": {
    "id": "DR12345",
    "first_name": "Jane",
    "last_name": "Smith",
    "npi": "5432167890",
    "name": "Jane Smith, MD"
  },
  "cpt_codes_cms1500s": [
    {
      "cpt_code": {
        "code": "99213"
      }
    },
    {
      "cpt_code": {
        "code": "85025"
      }
    }
  ],
  "icd_codes_cms1500s": [
    {
      "icd_code": {
        "code": "J20.9"
      }
    },
    {
      "icd_code": {
        "code": "R50.9"
      }
    }
  ]
}
'

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "information",
      "code": "informational",
      "diagnostics": "Claim created successfully"
    }
  ]
}

Overview

API Authentication

Eligibility

Enrollments

Claims

Webhooks

AI Phone Calls

Create Claim From Healthie CMS 1500

Authorizations

Query Parameters

Body

Response