JSON Schema for 837D (Dental Claim)
Claim
| Name | Description | Type | EDI Reference |
|---|---|---|---|
id | Unique payment identifier assigned by the converter | String | |
objectType | Type of this object, set to 'CLAIM' | String | |
patientControlNumber | Identifier used to track a claim from creation by the health care provider through payment | String Required | CLM01 |
chargeAmount | Charge amount | Number Required | CLM02 |
patientPaidAmount | Patient paid amount | Number | AMT02*F5 |
facilityCode | Place of service code (professional/dental) or UB facility code (institutional) from the original claim | Required | CLM05-1 |
frequencyCode | Frequency code | Required | CLM05-3 |
serviceDateFrom | The earliest service date from service lines | Date | |
serviceDateTo | The latest service date from service lines | Date | |
subscriber | The insured (subscriber) | 2000B | |
patient | Patient if different from the the insured (subscriber) | 2110CA | |
otherSubscribers | Other subscribers and their payer's information | List of OtherSubscriber | 2320 |
serviceLines | Service lines | List of DentLine | 2400 |
transaction | Parent EDI transaction for this object | ST | |
providerSignatureIndicator | Provider signature indicator | String Required | CLM06 |
assignmentParticipationCode | Assignment participation code | String Required | CLM07 |
assignmentCertificationIndicator | Assignment certification indicator | String Required | CLM08 |
releaseOfInformationCode | Release of information code | String Required | CLM09 |
relatedCause | Related cause | CLM11 | |
specialProgramCode | Special program code | String | CLM12 |
delayReasonCode | Delay reason code | String | CLM20 |
serviceAuthorizationExceptionCode | Service authorization exception code | String | REF02*4N |
referralNumber | Referral number | String | REF02*9F |
priorAuthorizationNumber | Prior authorization number | String | REF02*G1 |
originalReferenceNumber | Original reference number | String | REF02*F8 |
repricedReferenceNumber | Repriced reference number | String | REF02*9A |
adjustedRepricedReferenceNumber | Adjusted repriced reference number | String | REF02*9C |
clearinghouseTraceNumber | Clearinghouse trace number | String | REF02*D9 |
medicalRecordNumber | Medical record number | String | REF02*EA |
demonstrationProjectIdentifier | Demonstration project identifier | String | REF02*P4 |
accidentDate | Accident date | Date | DTP03*439 |
orthodonticBandingDate | Orthodontic banding date | Date | DTP03*452 |
repricerReceivedDate | Repricer received date | Date | DTP03*050 |
orthodonticInfo | Orthodontic info | ||
toothStatuses | Tooth statuses | List of ToothStatus | |
predeterminationOfBenefitsIdentifier | Predetermination of benefits identifier | String | REF02*G3 |
fixedFormatRecords | Fixed format records | List of String | K301 |
claimNote | Free-form comments or instructions. All note segments are concatenated together into this field | String | NTE02 |
billingProvider | Billing provider | NM1*85 | |
payToAddress | Pay to address | NM1*87 | |
payToPlan | Pay-to plan for subrogation claims | NM1*PE | |
providers | Providers for this claim, except for the billing provider | List of Provider | |
attachments | Attachments | List of Attachment | PWK |
contractInfo | Contract info | CN1 |
Orthodontic Info
| Name | Description | Type | EDI Reference |
|---|---|---|---|
treatmentMonthsCount | Treatment months count | Number | DN101 |
treatmentMonthsRemainingCount | Treatment months remaining count | Number | DN102 |
treatmentIndicator | Treatment indicator | String | DN104 |
Tooth Status
| Name | Description | Type | EDI Reference |
|---|---|---|---|
toothNumber | Tooth number | String | DN201 |
statusCode | Status code | String | DN202 |
Service Line
| Name | Description | Type | EDI Reference |
|---|---|---|---|
sourceLineId | Line item control number | String | REF02*6R |
oralCavityDesignationCodes | Oral cavity designation codes | List of String | SV304 |
prosthesisCrownOrInlayCode | Prosthesis crown or inlay code | String | SV305 |
predeterminationOfBenefitsIdentifier | Predetermination of benefits identifier | String | REF02*G3 |
repricedReferenceNumber | Repriced reference number | String | REF02*9B |
adjustedRepricedReferenceNumber | Adjusted repriced reference number | String | REF02*9D |
priorAuthorization | Prior authorization | String | REF02*G1 |
referralNumber | Referral number | String | REF02*9F |
chargeAmount | Charge amount | Number Required | SV302 |
salesTaxAmount | Sales tax amount | Number | AMT02*T |
serviceDateFrom | Service date from | Date | DTP03*472 |
serviceDateTo | Service date to | Date | DTP03*472 |
priorPlacementDate | Prior placement date | Date | DTP03*441 DTP03*139 |
orthodonticBandingDate | Orthodontic banding date | Date | DTP03*452 |
replacementDate | Replacement date | Date | DTP03*446 |
treatmentStartDate | Treatment start date | Date | DTP03*196 |
treatmentCompletionDate | Treatment completion date | Date | DTP03*198 |
unitCount | Unit count | Number | SV306 |
procedure | Procedure | SV302*HC SV302*AD SV302*WK SV302*IV | |
attachments | Attachments | List of Attachment | PWK |
contractInfo | Contract info | CN1 | |
providers | Providers for this service line | List of Provider | |
adjudications | Adjudications | List of Adjudication | 2430 SVD |
adjustments | Copy of line adjustments from the adjudication list for backward compatibility | List of Adjustment | CAS |
fixedFormatRecords | Fixed format records | List of String | K301 |
toothInfos | Tooth infos | List of ToothInfo | |
diagPointers | Diagnosis pointers. Each pointer is an index of the diagnosis in the 'diags' array at the claim level. | List of Integer Required | SV302 |
diags | Copy of diagnosis codes from the claim based on diagnosis pointers | List of Code | SV302 |
Tooth Info
| Name | Description | Type | EDI Reference |
|---|---|---|---|
code | Code | String | TOO02 |
surfaceCodes | Surface codes | List of String | TOO03 |
Subscriber
| Name | Description | Type | EDI Reference |
|---|---|---|---|
payerResponsibilitySequence | Payer responsibility sequence Values: EIGHT(E), ELEVEN(H), FIVE(B), FOUR(A), NINE(F), PRIMARY(P), SECONDARY(S), SEVEN(D), SIX(C), TEN(G), TERTIARY(T), UNCONFIRMED(N), UNKNOWN(U) | String (enum) Required | SBR01 |
relationshipType | Relationship type Values: CADAVER_DONOR(40), CHILD(19), EMPLOYEE(20), LIFE_PARTNER(53), ORGAN_DONOR(39), OTHER(G8), SELF(18), SPOUSE(1), UNKNOWN(21) | String (enum) | SBR02 PAT01 |
groupOrPolicyNumber | Group or policy number | String | SBR03 |
groupName | Group name | String | SBR04 |
claimFilingIndicatorCode | Claim filing indicator code | String | SBR09 |
insurancePlanType | Insurance plan type Values: AUTOMOBILE_MEDICAL(AM), BCBS(BL), CHAMPUS(CH), COMMERCIAL(CI), EPO(14), FEDERAL_EMPLOYEE_PROGRAM(FI), HMO(HM), HMO_MEDICARE(16), INDEMNITY_INSURANCE(15), MEDICAID(MC), MEDICARE_A(MA), MEDICARE_B(MB), MUTUALLY_DEFINED(ZZ), OTHER_FEDERAL(OF), OTHER_NON_FEDERAL(11), POS(13), PPO(12), VETERAN_AFFAIRS(VA), WORKERS_COMPENSATION(WC) | String (enum) | SBR09 |
person | Person | NM1 | |
deathDate | Death date | Date | PAT06 |
weight | Patient weight in pounds | Number | PAT08 |
pregnancyIndicator | Pregnancy indicator | String | PAT09 |
propertyCasualtyClaimNumber | Property casualty claim number | String | REF02*Y4 |
payer | Payer | 2330B NM1*PR |
Patient
| Name | Description | Type | EDI Reference |
|---|---|---|---|
relationshipType | Relationship type Values: CADAVER_DONOR(40), CHILD(19), EMPLOYEE(20), LIFE_PARTNER(53), ORGAN_DONOR(39), OTHER(G8), SELF(18), SPOUSE(1), UNKNOWN(21) | String (enum) | SBR02 PAT01 |
person | Person | NM1 | |
deathDate | Death date | Date | PAT06 |
weight | Patient weight in pounds | Number | PAT08 |
pregnancyIndicator | Pregnancy indicator | String | PAT09 |
Other Subscriber
| Name | Description | Type | EDI Reference |
|---|---|---|---|
payerResponsibilitySequence | Payer responsibility sequence Values: EIGHT(E), ELEVEN(H), FIVE(B), FOUR(A), NINE(F), PRIMARY(P), SECONDARY(S), SEVEN(D), SIX(C), TEN(G), TERTIARY(T), UNCONFIRMED(N), UNKNOWN(U) | String (enum) Required | SBR01 |
relationshipType | Relationship type Values: CADAVER_DONOR(40), CHILD(19), EMPLOYEE(20), LIFE_PARTNER(53), ORGAN_DONOR(39), OTHER(G8), SELF(18), SPOUSE(1), UNKNOWN(21) | String (enum) | SBR02 PAT01 |
groupOrPolicyNumber | Group or policy number | String | SBR03 |
groupName | Group name | String | SBR04 |
coordinationOfBenefitsCode | Coordination of benefits code, post-adjudicated claims only | String | SBR06 |
claimFilingIndicatorCode | Claim filing indicator code | String | SBR09 |
insurancePlanType | Insurance plan type Values: AUTOMOBILE_MEDICAL(AM), BCBS(BL), CHAMPUS(CH), COMMERCIAL(CI), EPO(14), FEDERAL_EMPLOYEE_PROGRAM(FI), HMO(HM), HMO_MEDICARE(16), INDEMNITY_INSURANCE(15), MEDICAID(MC), MEDICARE_A(MA), MEDICARE_B(MB), MUTUALLY_DEFINED(ZZ), OTHER_FEDERAL(OF), OTHER_NON_FEDERAL(11), POS(13), PPO(12), VETERAN_AFFAIRS(VA), WORKERS_COMPENSATION(WC) | String (enum) | SBR09 |
person | Person | NM1 | |
adjustments | Claim-level adjustments from this payer | List of Adjustment | CAS |
payerPaidAmount | Payer paid amount | Number | AMT02*D |
nonCoveredAmount | Non covered amount | Number | AMT02*A8 |
remainingPatientLiabilityAmount | Remaining patient liability amount | Number | AMT02*EAF |
outpatientAdjudication | Outpatient adjudication | MOA | |
payerPriorAuthorizationNumber | Payer prior authorization number | String | REF02*G1 |
payerReferralNumber | Payer referral number | String | REF02*9F |
payerClaimControlNumber | Payer claim control number | String | REF02*F8 |
payer | Payer | 2330B NM1*PR | |
patient | Patient's information; post-adjudicated claims only | 2330C NM1*QC | |
providers | Other payer's providers | List of Party | NM1 |
Outpatient Adjudication
| Name | Description | Type | EDI Reference |
|---|---|---|---|
reimbursementRate | Reimbursement rate | Number | MOA01 |
hcpcsPayableAmount | Claim HCPCS Payable Amount | Number | MOA02 |
esrdPaymentAmount | Esrd payment amount | Number | MOA08 |
nonPayableProfessionalComponentAmount | Nonpayable Professional Component Amount | Number | MOA09 |
remarks | Remark codes | List of Code | MOA3:7 |
Organization Or Person ID and Name
| Name | Description | Type | EDI Reference |
|---|---|---|---|
entityRole | Entity role | String Required | NM101 N101 |
entityType | Type of this entity: 'BUSINESS' for organization, 'INDIVIDUAL' for person Values: BUSINESS(2), INDIVIDUAL(1) | String (enum) Required | NM102 |
identificationType | Identification type, e.g., NPI or EIN. This is a qualifier code translated to a string constant (enum) | String | NM108 N103 |
identifier | Identifier | String | NM109 N104 |
taxId | Tax id | String | REF02*TJ REF02*SY REF02*EI |
lastNameOrOrgName | Organization name or person last name | String | NM103 N102 |
firstName | First name | String | NM104 |
middleName | Middle name | String | NM105 |
Organization or Person (Party)
| Name | Description | Type | EDI Reference |
|---|---|---|---|
address | Address | ||
contacts | Contacts | List of ContactInfo | |
additionalIds | Other identifications | List of Reference | REF |
Provider
| Name | Description | Type | EDI Reference |
|---|---|---|---|
providerTaxonomy | Provider's specialty information (taxonomy). Populated only for billing, rendering, operating providers. | PRV |
Person with Demographic Info
| Name | Description | Type | EDI Reference |
|---|---|---|---|
birthDate | Birth date | Date | DMG02 |
gender | Gender Values: FEMALE(F), MALE(M), UNKNOWN(U) | String (enum) | DMG03 |
Contact Info
| Name | Description | Type | EDI Reference |
|---|---|---|---|
functionCode | Function code | String Required | PER01 |
name | Name | String | PER02 |
contactNumbers | Contact numbers | List of ContactNumber |
Contact Number
| Name | Description | Type | EDI Reference |
|---|---|---|---|
type | Type of contact number Values: ALTERNATE_PHONE, BEEPER, CELL_PHONE, EMAIL, EXTENSION, FAX, HOME_PHONE, PHONE, UNKNOWN, URL, WORK_PHONE | String (enum) Required | PER03 PER05 PER07 |
number | Number | String Required | PER04 PER06 PER08 |
Related Cause Info
| Name | Description | Type | EDI Reference |
|---|---|---|---|
relatedCauseCode | Related cause code | String | CLM11-1 |
relatedCauseCode2 | Related cause code2 | String | CLM11-2 |
stateCode | State code | String | CLM11-4 |
countryCode | Country code | String | CLM11-5 |
Adjudication
| Name | Description | Type | EDI Reference |
|---|---|---|---|
payerIdentifier | Payer identifier | String | SVD01 |
paidAmount | Paid amount | Number | SVD02 |
unitCount | Unit count | Number | SVD05 |
bundledOrUnbundledLineNumber | Bundled or unbundled line number | Integer | SVD06 |
procedure | Procedure | SVD03 | |
adjustments | Line adjustments | List of Adjustment | CAS |
adjudicationOrPaymentDate | Adjudication or payment date | Date | DTP03*573 |
remainingPatientLiabilityAmount | Remaining patient liability amount | Number | AMT02*EAF |
Adjustment
| Name | Description | Type | EDI Reference |
|---|---|---|---|
group | Claim adjustment group code as a string constant Values: CONTRACTUAL(CO), CORRECTION(CR), OTHER(OA), PATIENT_RESPONSIBILITY(PR), PAYOR_INITIATED(PI) | String (enum) Required | CAS01 |
reason | Claim adjustment reason code | Required | CAS02 |
amount | Adjustment amount | Number Required | CAS03 |
quantity | Adjustment quantity | Number | CAS04 |
Attachment
| Name | Description | Type | EDI Reference |
|---|---|---|---|
reportTypeCode | Report type code | String Required | PWK01 |
reportTransmissionCode | Report transmission code | String Required | PWK02 |
controlNumber | Control number | String | PWK06 |
Contract Info
| Name | Description | Type | EDI Reference |
|---|---|---|---|
contractTypeCode | Contract type code | String Required | CN101 |
amount | Amount | Number | CN102 |
percentage | Percentage | Number | CN103 |
contractCode | Contract code | String | CN104 |
termDiscountPercentage | Term discount percentage | Number | CN105 |
versionIdentifier | Version identifier | String | CN106 |
Procedure
| Name | Description | Type | EDI Reference |
|---|---|---|---|
modifiers | Modifiers | List of Code | 837P:SV101-3-6 837I:SV201-3-6 835:SVC01-3-6 277:SVC01-3-6 |
Code
| Name | Description | Type |
|---|---|---|
subType | Healthcare code subtype, such as CPT, HCPCS, ICD_10, NDC | String |
code | Healthcare code | String Required |
desc | Code description | String |
EDI Transaction Info
| Name | Description | Type | EDI Reference |
|---|---|---|---|
controlNumber | Control number | String | ST02 |
transactionType | Transaction type translated to string constant, PROF for 837P, INST for 837I, etc. | String | ST01 ST03 |
hierarchicalStructureCode | Hierarchical structure code | String | BHT01 |
purposeCode | Purpose code | String | BHT02 |
originatorApplicationTransactionId | Originator application transaction id | String | BHT03 |
creationDate | Creation date | Date | BHT04 |
creationTime | Creation time | Time | BHT05 |
claimOrEncounterIdentifierType | Claim or encounter identifier type | String | BHT06 |
transactionSetIdentifierCode | Transaction set identifier code | String | ST01 |
implementationConventionReference | Implementation convention reference | String | ST03 |
fileInfo | File info | ||
sender | Submitter or sender of this transaction | ||
receiver | Receiver of this transaction |
Organization Or Person ID and Name
| Name | Description | Type | EDI Reference |
|---|---|---|---|
entityRole | Entity role | String Required | NM101 N101 |
entityType | Type of this entity: 'BUSINESS' for organization, 'INDIVIDUAL' for person Values: BUSINESS(2), INDIVIDUAL(1) | String (enum) Required | NM102 |
identificationType | Identification type, e.g., NPI or EIN. This is a qualifier code translated to a string constant (enum) | String | NM108 N103 |
identifier | Identifier | String | NM109 N104 |
taxId | Tax id | String | REF02*TJ REF02*SY REF02*EI |
lastNameOrOrgName | Organization name or person last name | String | NM103 N102 |
firstName | First name | String | NM104 |
middleName | Middle name | String | NM105 |
File Info
| Name | Description | Type |
|---|---|---|
name | File name | String |
url | URL of the file, including the full path | String |
lastModifiedDateTime | Last modified date and time of the file | Date and Time |