POST
/
api
/
claim
/
healthie
/
v1
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

id
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

billing_provider
object
required

Information about the billing provider

rendering_provider
object
required

Information about the rendering provider

cpt_codes_cms1500s
object[]
required

CPT codes associated with the claim

icd_codes_cms1500s
object[]
required

ICD diagnosis codes associated with the claim

service_location
object

Location of the 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

id
string

Logical id of this artifact