Skip to main content

CreateClaimEdi Field Map (837I)

With "claimType": "institutional", POST /api/SharpRcm/v1/CreateClaimEdi builds an 837I (005010X223A2). This page lists every field of the request and the loop, segment and element it is written to. The 837P field map explains how to read the tables and describes the shared building blocks (provider, address, contact, date, reference, adjustment).

The request model is the same for every claim type, so some fields mean something different on an 837I: claimEditorView.placeOfService is the facility type code, and salesTaxAmount / postageClaimedAmt on a line are the service and facility tax amounts. Fields the 837I has no place for are listed under Not sent.

The tables below are generated from a test that builds an 837I from a request with every field filled in and confirms each value lands where the table says. They cannot drift from what the API sends.

Request​

Fields on the request itself. They build the envelope and the submitter and receiver loops.

JSON field837Notes
submitterName1000A NM1*41 NM103
submitterId1000A NM1*41 NM109Also ISA06 and GS02 when envelop.isa06 / envelop.gs02 are empty.
submitterContactName1000A PER PER02
submitterPhone1000A PER PER04PER03 is always TE.
receiverName1000B NM1*40 NM103Used only when envelop.receiverName is empty.
transactionControlNumberST ST02Also SE02.
bhtControlNumberBHT BHT03
groupControlNumberGS GS06Also GE02.
envelop.isa01ISA ISA01
envelop.isa02ISA ISA02Pad to 10.
envelop.isa03ISA ISA03
envelop.isa04ISA ISA04Pad to 10.
envelop.isa05ISA ISA05
envelop.isa06ISA ISA06Pad to 15. Falls back to submitterId.
envelop.isa07ISA ISA07
envelop.isa08ISA ISA08Pad to 15.
envelop.isa13ISA ISA13Nine digits. Also IEA02.
envelop.isa14ISA ISA14
envelop.isa15ISA ISA15P production, T test.
envelop.gs01GS GS01HC when empty.
envelop.gs02GS GS02Falls back to submitterId.
envelop.gs03GS GS03Also 1000B NM109 when envelop.receiverId is empty.
envelop.gs08GS GS08Also ST03. Send 005010X223A2, or leave it empty and it is set from claimType.
envelop.receiverName1000B NM1*40 NM103
envelop.receiverId1000B NM1*40 NM109
envelop.bht02BHT BHT02
envelop.bht06BHT BHT06

Billing provider (2000A, 2010AA)​

Paths are relative to each entry in claims[].

JSON field837Notes
billingProviderEditorView.nm1Data.entityCode2010AA NM1*85 NM101Filled in as 85.
billingProviderEditorView.nm1Data.entityType2010AA NM1*85 NM102
billingProviderEditorView.nm1Data.lastName2010AA NM1*85 NM103
billingProviderEditorView.nm1Data.firstName2010AA NM1*85 NM104
billingProviderEditorView.nm1Data.middleName2010AA NM1*85 NM105
billingProviderEditorView.nm1Data.suffix2010AA NM1*85 NM107
billingProviderEditorView.nm1Data.npi2010AA NM1*85 NM109
billingProviderEditorView.nm1Data.taxonomyCode2000A PRV*BI PRV03
billingProviderEditorView.address1, address2, city, state, zip2010AA N3, N4 (address)
billingProviderEditorView.secondaryIdentifiers[].qualifierCode2010AA REF*EI REF01The tax id: the first EI or SY entry is written. otherRefValue is not sent. Send EI.
billingProviderEditorView.secondaryIdentifiers[].refValue2010AA REF*EI REF02
billingProviderEditorView.contact12010AA PER (contact)Written when contactType1 and contactInfo1 are set.
billingProviderEditorView.contact22010AA PER (contact)Written when contactType1 and contactInfo1 are set.

Pay-to address and plan (2010AB, 2010AC)​

Paths are relative to each entry in claims[].

JSON field837Notes
payToAddressView.entityType2010AB NM1*87 NM102The loop is written when address1 is set. NM101 is always 87.
payToAddressView.address1, address2, city, state, zip2010AB N3, N4 (address)
payToPlanView.organizationName2010AC NM1*PE NM103The loop is written when organizationName is set.
payToPlanView.primaryIdentifier2010AC NM1*PE NM109
payToPlanView.address1, address2, city, state, zip2010AC N3, N4 (address)
payToPlanView.secondaryIdentifierType2010AC REF*2U REF01Send 2U.
payToPlanView.secondaryIdentifier2010AC REF*2U REF02
payToPlanView.taxIdNumber2010AC REF*EI REF02

Subscriber (2000B, 2010BA)​

Paths are relative to each entry in claims[].

JSON field837Notes
subscriberEditorView.payerResponsibility2000B SBR01relationshipCode is written exactly as sent: 18 when the subscriber is the patient, empty when patientEditorView is used.
subscriberEditorView.relationshipCode2000B SBR02
subscriberEditorView.policyNumber2000B SBR03
subscriberEditorView.groupName2000B SBR04
subscriberEditorView.insuranceTypeCode2000B SBR05
subscriberEditorView.claimFilingIndicator2000B SBR09
subscriberEditorView.dateOfDeath2000B PAT06Written when any of dateOfDeath, weight or pregnancyIndicator is set.
subscriberEditorView.measurementCode2000B PAT07
subscriberEditorView.weight2000B PAT08
subscriberEditorView.pregnancyIndicator2000B PAT09
subscriberEditorView.entityType2010BA NM1*IL NM102NM108 is always MI.
subscriberEditorView.lastName2010BA NM1*IL NM103
subscriberEditorView.firstName2010BA NM1*IL NM104
subscriberEditorView.middleName2010BA NM1*IL NM105
subscriberEditorView.suffix2010BA NM1*IL NM107
subscriberEditorView.subscriberPrimaryIdent2010BA NM1*IL NM109
subscriberEditorView.address1, address2, city, state, zip2010BA N3, N4 (address)
subscriberEditorView.birthDay2010BA DMG02Written when either is set.
subscriberEditorView.gender2010BA DMG03
subscriberEditorView.ssn2010BA REF*SY REF02
subscriberEditorView.casualtyClaimNumber2010BA REF*Y4 REF02

Payer (2010BB)​

Paths are relative to each entry in claims[].

JSON field837Notes
payerEditerView.organizationName2010BB NM1*PR NM103Note the spelling: payerEditerView.
payerEditerView.payerIdentifier2010BB NM1*PR NM109Routes the claim. NM108 is always PI.
payerEditerView.address1, address2, city, state, zip2010BB N3, N4 (address)
payerEditerView.taxIdNumber2010BB REF*EI REF02
payerEditerView.claimOfficeNumber2010BB REF*FY REF02
payerEditerView.naicCode2010BB REF*NF REF02
payerEditerView.locationNumber2010BB REF*LU REF02
payerEditerView.providerCommericalNumber2010BB REF*G2 REF02

Patient (2000C, 2010CA)​

Paths are relative to each entry in claims[].

JSON field837Notes
patientEditorView.relationshipCode2000C PAT PAT01Creates the patient loop. Without it nothing in patientEditorView is written.
patientEditorView.dateOfDeath2000C PAT06
patientEditorView.measurementCode2000C PAT07
patientEditorView.weight2000C PAT08
patientEditorView.pregnancyIndicator2000C PAT09
patientEditorView.lastName2010CA NM1*QC NM103NM102 is always 1.
patientEditorView.firstName2010CA NM1*QC NM104
patientEditorView.middleName2010CA NM1*QC NM105
patientEditorView.suffix2010CA NM1*QC NM107
patientEditorView.address1, address2, city, state, zip2010CA N3, N4 (address)
patientEditorView.birthDay2010CA DMG02
patientEditorView.gender2010CA DMG03
patientEditorView.casualtyClaimNumber2010CA REF*Y4 REF02

Claim (2300)​

Paths are relative to each entry in claims[].

JSON field837Notes
claimEditorView.patientControlNumber2300 CLM CLM01Your claim id. It comes back on the 277CA and 835.
claimEditorView.totalClaimChargeAmt2300 CLM CLM02Must equal the sum of the line charges.
claimEditorView.placeOfService2300 CLM CLM05-1The facility type code: the first two digits of the type of bill. CLM05-2 is always A.
claimEditorView.claimFreqCode2300 CLM CLM05-3The frequency: the last digit of the type of bill. 1 original, 7 replacement, 8 void.
claimEditorView.providerSignatureOnFile2300 CLM CLM06
claimEditorView.planParticipationCode2300 CLM CLM07
claimEditorView.benefitsAssignmentCertIndicator2300 CLM CLM08
claimEditorView.releaseOfInfoCode2300 CLM CLM09
claimEditorView.delayReasonCode2300 CLM CLM20
claimEditorView.dateStatementDate.dateQualifier2300 DTP*434 DTP01The statement period, CCYYMMDD-CCYYMMDD. A dateValue with a hyphen is sent as RD8. Filled in as 434.
claimEditorView.dateStatementDate.dateValue2300 DTP*434 DTP03Send 20300101-20300105.
claimEditorView.dateStatementDate.periodFormat2300 DTP*434 DTP02Filled in as RD8.
claimEditorView.dateAdmissionDate.dateQualifier2300 DTP*435 DTP01Admission date, CCYYMMDD, or date and hour, CCYYMMDDHHMM (sent as DT). Filled in as 435.
claimEditorView.dateAdmissionDate.dateValue2300 DTP*435 DTP03Send 203001011230.
claimEditorView.dateAdmissionDate.periodFormat2300 DTP*435 DTP02Filled in as DT.
claimEditorView.dateDischarge.dateQualifier2300 DTP*096 DTP01Discharge hour, HHMM (sent as TM). Filled in as 096.
claimEditorView.dateDischarge.dateValue2300 DTP*096 DTP03Send 1430.
claimEditorView.dateDischarge.periodFormat2300 DTP*096 DTP02Filled in as TM.
claimEditorView.dateRepricerReceived2300 DTP*050 (date)
claimEditorView.claimCode.admissionTypeCode2300 CL101Written when patientStatusCode is set.
claimEditorView.claimCode.admissionSourceCode2300 CL102
claimEditorView.claimCode.patientStatusCode2300 CL103
claimEditorView.supplementalInfos[].reportTypeCode2300 PWK01Up to 10. PWK05 is AC when the transmission code is BM, EL, EM, FX or FT.
claimEditorView.supplementalInfos[].transmissionCode2300 PWK02
claimEditorView.supplementalInfos[].attachmentControlNumber12300 PWK06
claimEditorView.contractInfo.contractTypeCode2300 CN101Written when contractTypeCode is set.
claimEditorView.contractInfo.contractAmt2300 CN102
claimEditorView.contractInfo.contractPercent2300 CN103
claimEditorView.contractInfo.contractCode2300 CN104
claimEditorView.contractInfo.contractTermsPercent2300 CN105
claimEditorView.contractInfo.contractVersionIdent2300 CN106
claimEditorView.patientPaidAmount.amount2300 AMT*F3 AMT02The patient's estimated amount due. AMT01 is always F3.
claimEditorView.refReferralNumber2300 REF*9F (reference)
claimEditorView.refPriorAuthorization2300 REF*G1 (reference)
claimEditorView.refOriginalReference2300 REF*F8 (reference)The payer's claim number, for a replacement or void.
claimEditorView.refRepricedClaimReference2300 REF*9A (reference)
claimEditorView.refAdjRepricedClaimRerence2300 REF*9C (reference)
claimEditorView.refQualifiedProductsList2300 REF*LX (reference)
claimEditorView.refTraceNumber2300 REF*D9 (reference)
claimEditorView.refLocationNumber2300 REF*LU (reference)
claimEditorView.refMedicalRecordIdent2300 REF*EA (reference)
claimEditorView.refProjectCode2300 REF*P4 (reference)
claimEditorView.refProApprovalNumber2300 REF*G4 (reference)
claimEditorView.fileInformations[]2300 K3 K301Up to 10.
claimEditorView.note.noteText2300 NTE*ADD NTE02The billing note. NTE01 is always ADD.
claimEditorView.notes[].referenceCode2300 NTE*UPI NTE01Other claim notes, each with its own referenceCode. A referenceCode of ADD is skipped; use note for that. Send UPI.
claimEditorView.notes[].noteText2300 NTE*UPI NTE02
claimEditorView.epsdt.conditionIndicator2300 CRC*ZZ CRC02Written when conditionIndicator is set. CRC01 is always ZZ.
claimEditorView.epsdt.conditionCode12300 CRC*ZZ CRC03
claimEditorView.epsdt.conditionCode22300 CRC*ZZ CRC04
claimEditorView.epsdt.conditionCode32300 CRC*ZZ CRC05
claimEditorView.diagnosisCodes[].diagnosisType2300 HI*ABK HI01-1The entry with diagnosisOrder 1 is the principal diagnosis, in its own HI; the rest go in one HI*ABF (12 to a segment). presentOnAdmission is the POA indicator. Send ABK.
claimEditorView.diagnosisCodes[].diagnosisCode2300 HI*ABK HI01-2
claimEditorView.diagnosisCodes[].presentOnAdmission2300 HI*ABK HI01-9
claimEditorView.diagnosisCodes[].diagnosisType2300 HI*ABF HI01-1Send ABF.
claimEditorView.diagnosisCodes[].diagnosisCode2300 HI*ABF HI01-2
claimEditorView.diagnosisCodes[].presentOnAdmission2300 HI*ABF HI01-9
claimEditorView.admittingDiagnosisCode.diagnosisType2300 HI*ABJ HI01-1diagnosisType is always ABJ. Filled in as ABJ.
claimEditorView.admittingDiagnosisCode.diagnosisCode2300 HI*ABJ HI01-2
claimEditorView.reasonForVisitDiagnosisCodes[].diagnosisType2300 HI*APR HI01-1Patient reason for visit, APR. Send APR.
claimEditorView.reasonForVisitDiagnosisCodes[].diagnosisCode2300 HI*APR HI01-2
claimEditorView.externalCauseInjDiagnosisCodes[].diagnosisType2300 HI*ABN HI01-1External cause of injury, ABN, with its POA indicator. Send ABN.
claimEditorView.externalCauseInjDiagnosisCodes[].diagnosisCode2300 HI*ABN HI01-2
claimEditorView.externalCauseInjDiagnosisCodes[].presentOnAdmission2300 HI*ABN HI01-9
claimEditorView.principalProcedureCode.diagnosisType2300 HI*BBR HI01-1ICD-10-PCS principal procedure, BBR. With procedureDate, HI01-3 is D8. Send BBR.
claimEditorView.principalProcedureCode.diagnosisCode2300 HI*BBR HI01-2
claimEditorView.principalProcedureCode.procedureDate2300 HI*BBR HI01-4
claimEditorView.otherPrincipalProcedureCodes[].diagnosisType2300 HI*BBQ HI01-1Other procedures, BBQ, one composite each. Send BBQ.
claimEditorView.otherPrincipalProcedureCodes[].diagnosisCode2300 HI*BBQ HI01-2
claimEditorView.otherPrincipalProcedureCodes[].procedureDate2300 HI*BBQ HI01-4
claimEditorView.drgCode2300 HI*DR HI01-2Diagnosis related group.
claimEditorView.occurrenceSpanCodes[].diagnosisType2300 HI*BI HI01-1Occurrence span code and range (procedureDate, CCYYMMDD-CCYYMMDD); HI01-3 is RD8. Send BI.
claimEditorView.occurrenceSpanCodes[].diagnosisCode2300 HI*BI HI01-2
claimEditorView.occurrenceSpanCodes[].procedureDate2300 HI*BI HI01-4
claimEditorView.occurrenceCodes[].diagnosisType2300 HI*BH HI01-1Occurrence code and date (procedureDate); HI01-3 is D8. Send BH.
claimEditorView.occurrenceCodes[].diagnosisCode2300 HI*BH HI01-2
claimEditorView.occurrenceCodes[].procedureDate2300 HI*BH HI01-4
claimEditorView.valueInformation[].diagnosisType2300 HI*BE HI01-1Value code and amount (monitaryAmount). Send BE.
claimEditorView.valueInformation[].diagnosisCode2300 HI*BE HI01-2
claimEditorView.valueInformation[].monitaryAmount2300 HI*BE HI01-5
claimEditorView.conditionCodes[]2300 HI*BGCondition codes, BG:<code> each, 12 to a segment.
claimEditorView.treatmentCodes[]2300 HI*TCTreatment codes, TC:<code> each, 12 to a segment.
claimEditorView.repricing.pricingMethodology2300 HCP01Written when pricingMethodology and repricedAllowedAmt are set.
claimEditorView.repricing.repricedAllowedAmt2300 HCP02
claimEditorView.repricing.repriceSavingsAmt2300 HCP03
claimEditorView.repricing.repricingOrgIdent2300 HCP04
claimEditorView.repricing.rate2300 HCP05
claimEditorView.repricing.groupCode2300 HCP06
claimEditorView.repricing.patientGroupAmt2300 HCP07
claimEditorView.repricing.rejectReasonCode2300 HCP13
claimEditorView.repricing.complianceCode2300 HCP14
claimEditorView.repricing.exceptionCode2300 HCP15
claimEditorView.attendingProvider2310A NM1*71, PRV*AT, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as 71.
claimEditorView.operatingProvider2310B NM1*72, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as 72.
claimEditorView.otherOperatingProvider2310C NM1*ZZ, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as ZZ.
claimEditorView.renderingProvider2310D NM1*82, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as 82.
claimEditorView.serviceFacility.organizationName2310E NM1*77 NM103Written when organizationName is set. NM108 is XX when primaryIdentifier (the NPI) is set.
claimEditorView.serviceFacility.primaryIdentifier2310E NM1*77 NM109
claimEditorView.serviceFacility.address12310E N301
claimEditorView.serviceFacility.address22310E N302
claimEditorView.serviceFacility.city2310E N401
claimEditorView.serviceFacility.state2310E N402
claimEditorView.serviceFacility.zip2310E N403
claimEditorView.serviceFacility.secondaryIdentifiers[].qualifierCode2310E REF*G2 REF01Send G2.
claimEditorView.serviceFacility.secondaryIdentifiers[].refValue2310E REF*G2 REF02
claimEditorView.serviceFacility.secondaryIdentifiers[].otherRefValue2310E REF*G2 REF04
claimEditorView.referringProvider2310F NM1*DN, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as DN.

Other payers (2320, 2330A-I)​

Paths are relative to each entry in claims[].

JSON field837Notes
secondaryEditorView[].otherSubscriber.payerResponsibility2320 SBR01payerResponsibility and relationshipCode are both required; without them the whole entry is dropped.
secondaryEditorView[].otherSubscriber.relationshipCode2320 SBR02
secondaryEditorView[].otherSubscriber.policyNumber2320 SBR03
secondaryEditorView[].otherSubscriber.groupName2320 SBR04
secondaryEditorView[].otherSubscriber.claimFilingIndicator2320 SBR09
secondaryEditorView[].lineAdjustments[]2320 CAS (adjustment)Claim-level adjustments, one entry per group code.
secondaryEditorView[].payerPaidAmt.amountQualCode2320 AMT*D AMT01Filled in as D.
secondaryEditorView[].payerPaidAmt.monetaryAmt2320 AMT*D AMT02
secondaryEditorView[].nonCoveredAmount.amountQualCode2320 AMT*A8 AMT01Filled in as A8.
secondaryEditorView[].nonCoveredAmount.monetaryAmt2320 AMT*A8 AMT02
secondaryEditorView[].amountOwed.amountQualCode2320 AMT*EAF AMT01Filled in as EAF.
secondaryEditorView[].amountOwed.monetaryAmt2320 AMT*EAF AMT02
secondaryEditorView[].benefitsAssignmentCertIndicator2320 OI03Written when benefitsAssignmentCertIndicator is set.
secondaryEditorView[].releaseOfInfoCode2320 OI06
secondaryEditorView[].inpatientAdjudication.coveredDaysVisitCount2320 MIA01Medicare inpatient adjudication. Written when coveredDaysVisitCount is set.
secondaryEditorView[].inpatientAdjudication.lifetimePsychiatricDaysCount2320 MIA03
secondaryEditorView[].inpatientAdjudication.claimDrgAmount2320 MIA04
secondaryEditorView[].inpatientAdjudication.claimPaymentRemarkCode2320 MIA05
secondaryEditorView[].inpatientAdjudication.disproportionateShareAmt2320 MIA06
secondaryEditorView[].inpatientAdjudication.passThroughAmt2320 MIA07
secondaryEditorView[].inpatientAdjudication.ppsCapitalAmt2320 MIA08
secondaryEditorView[].inpatientAdjudication.ppsCapitalFspDrgAmt2320 MIA09
secondaryEditorView[].inpatientAdjudication.ppsCapitalDshDrgAmt2320 MIA11
secondaryEditorView[].inpatientAdjudication.oldCapitalAmt2320 MIA12
secondaryEditorView[].inpatientAdjudication.ppsCapitalImeAmt2320 MIA13
secondaryEditorView[].inpatientAdjudication.ppsOperatingHospitalDrgAmt2320 MIA14
secondaryEditorView[].inpatientAdjudication.costReportDayCount2320 MIA15
secondaryEditorView[].inpatientAdjudication.ppsOperatingFederalDrgAmt2320 MIA16
secondaryEditorView[].inpatientAdjudication.claimPpsCapitalOutlierAmt2320 MIA17
secondaryEditorView[].inpatientAdjudication.claimIndirectTeachingAmt2320 MIA18
secondaryEditorView[].inpatientAdjudication.nonPayableProComponentBilledAmt2320 MIA19
secondaryEditorView[].inpatientAdjudication.claimPaymentRemarkCode12320 MIA20
secondaryEditorView[].inpatientAdjudication.claimPaymentRemarkCode22320 MIA21
secondaryEditorView[].inpatientAdjudication.claimPaymentRemarkCode32320 MIA22
secondaryEditorView[].inpatientAdjudication.claimPaymentRemarkCode42320 MIA23
secondaryEditorView[].inpatientAdjudication.ppsCapitalExceptionAmt2320 MIA24
secondaryEditorView[].reimbursementRate2320 MOA01Medicare outpatient adjudication. Written when any is set.
secondaryEditorView[].hcpcsPayableAmt2320 MOA02
secondaryEditorView[].claimPaymentRemarkCode12320 MOA03
secondaryEditorView[].claimPaymentRemarkCode22320 MOA04
secondaryEditorView[].claimPaymentRemarkCode32320 MOA05
secondaryEditorView[].claimPaymentRemarkCode42320 MOA06
secondaryEditorView[].claimPaymentRemarkCode52320 MOA07
secondaryEditorView[].endStageRenalDiseasePmtAmt2320 MOA08
secondaryEditorView[].nonPayableProfessionalCompBilledAmt2320 MOA09
secondaryEditorView[].otherSubscriber.entityType2330A NM1*IL NM102N4 needs city, state and zip all set.
secondaryEditorView[].otherSubscriber.lastName2330A NM1*IL NM103
secondaryEditorView[].otherSubscriber.firstName2330A NM1*IL NM104
secondaryEditorView[].otherSubscriber.middleName2330A NM1*IL NM105
secondaryEditorView[].otherSubscriber.suffix2330A NM1*IL NM107
secondaryEditorView[].otherSubscriber.subscriberPrimaryIdent2330A NM1*IL NM109
secondaryEditorView[].otherSubscriber.address12330A N301
secondaryEditorView[].otherSubscriber.address22330A N302
secondaryEditorView[].otherSubscriber.city2330A N401
secondaryEditorView[].otherSubscriber.state2330A N402
secondaryEditorView[].otherSubscriber.zip2330A N403
secondaryEditorView[].otherSubscriber.ssn2330A REF*SY REF02
secondaryEditorView[].payerEditorView.organizationName2330B NM1*PR NM103payerIdentifier is what each line's adjudications[].otherPayerPrimaryIdentifier must match.
secondaryEditorView[].payerEditorView.payerIdentifier2330B NM1*PR NM109
secondaryEditorView[].payerEditorView.address12330B N301
secondaryEditorView[].payerEditorView.address22330B N302
secondaryEditorView[].payerEditorView.city2330B N401
secondaryEditorView[].payerEditorView.state2330B N402
secondaryEditorView[].payerEditorView.zip2330B N403
secondaryEditorView[].payerEditorView.adjudicationPaymentDate.dateQualifier2330B DTP*573 DTP01Filled in as 573.
secondaryEditorView[].payerEditorView.adjudicationPaymentDate.dateValue2330B DTP*573 DTP03
secondaryEditorView[].payerEditorView.additionalPayerIdentifier2330B REF*2U REF02
secondaryEditorView[].payerEditorView.taxIdNumber2330B REF*EI REF02
secondaryEditorView[].payerEditorView.claimOfficeNumber2330B REF*FY REF02
secondaryEditorView[].payerEditorView.naicCode2330B REF*NF REF02
secondaryEditorView[].payerEditorView.priorAuthNumber2330B REF*G1 REF02
secondaryEditorView[].payerEditorView.referralNumber2330B REF*9F REF02
secondaryEditorView[].payerEditorView.signalCode2330B REF*T4 REF02
secondaryEditorView[].payerEditorView.origionalRefNumber2330B REF*F8 REF02
secondaryEditorView[].attendingProvider2330C NM1*71, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as 71.
secondaryEditorView[].operatingProvider2330D NM1*72, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as 72.
secondaryEditorView[].otherOperatingProvider2330E NM1*ZZ, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as ZZ.
secondaryEditorView[].serviceFacility.organizationName2330F NM1*77 NM103Written when organizationName is set. 2330F carries no address.
secondaryEditorView[].serviceFacility.primaryIdentifier2330F NM1*77 NM109
secondaryEditorView[].serviceFacility.secondaryIdentifiers[].qualifierCode2330F REF*G2 REF01Send G2.
secondaryEditorView[].serviceFacility.secondaryIdentifiers[].refValue2330F REF*G2 REF02
secondaryEditorView[].serviceFacility.secondaryIdentifiers[].otherRefValue2330F REF*G2 REF04
secondaryEditorView[].renderingProvider2330G NM1*82, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as 82.
secondaryEditorView[].referringProvider2330H NM1*DN, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as DN.
secondaryEditorView[].billingProviderEditorView2330I NM1*85, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as 85. Its address and contacts are not sent.

Service line (2400-2430)​

Paths are relative to each entry in claims[].

JSON field837Notes
serviceLinesEditorView[].lineNumber2400 LX01
serviceLinesEditorView[].revenueCode2400 SV201
serviceLinesEditorView[].procedureCodeQualifier2400 SV202-1
serviceLinesEditorView[].procedureCode2400 SV202-2
serviceLinesEditorView[].modifier12400 SV202-3
serviceLinesEditorView[].modifier22400 SV202-4
serviceLinesEditorView[].modifier32400 SV202-5
serviceLinesEditorView[].modifier42400 SV202-6
serviceLinesEditorView[].procedureDescription2400 SV202-7
serviceLinesEditorView[].lineChargeAmount2400 SV203
serviceLinesEditorView[].serviceUnitMeasurementCode2400 SV204
serviceLinesEditorView[].serviceUnitCount2400 SV205
serviceLinesEditorView[].nonCoveredChargeAmount2400 SV207
serviceLinesEditorView[].supplementalInfos[].reportTypeCode2400 PWK01Up to 10. PWK05 is AC when the transmission code is BM, EL, EM, FX or FT.
serviceLinesEditorView[].supplementalInfos[].transmissionCode2400 PWK02
serviceLinesEditorView[].supplementalInfos[].attachmentControlNumber12400 PWK06
serviceLinesEditorView[].dateService.dateQualifier2400 DTP*472 DTP01A dateValue with a hyphen (20260801-20260805) is sent as a range, RD8. Filled in as 472.
serviceLinesEditorView[].dateService.dateValue2400 DTP*472 DTP03Send 20300101-20300105.
serviceLinesEditorView[].dateService.periodFormat2400 DTP*472 DTP02Filled in as RD8.
serviceLinesEditorView[].refLineItemControlNumber2400 REF*6R (reference)Your line id; it comes back on the 835.
serviceLinesEditorView[].refRepricedLineItemRefNumber2400 REF*9B (reference)
serviceLinesEditorView[].refAdjRepricedLineItemRefNumber2400 REF*9D (reference)
serviceLinesEditorView[].salesTaxAmount.monetaryAmt2400 AMT*GT AMT02The service tax amount. AMT01 is always GT.
serviceLinesEditorView[].postageClaimedAmt.monetaryAmt2400 AMT*N8 AMT02The facility tax amount. AMT01 is always N8.
serviceLinesEditorView[].thirdPartyNote.referenceCode2400 NTE*TPO NTE01Written when noteText is set. Send TPO.
serviceLinesEditorView[].thirdPartyNote.noteText2400 NTE*TPO NTE02
serviceLinesEditorView[].repricing.pricingMethodology2400 HCP01Written when pricingMethodology and repricedAllowedAmt are set.
serviceLinesEditorView[].repricing.repricedAllowedAmt2400 HCP02
serviceLinesEditorView[].repricing.repriceSavingsAmt2400 HCP03
serviceLinesEditorView[].repricing.repricingOrgIdent2400 HCP04
serviceLinesEditorView[].repricing.rate2400 HCP05
serviceLinesEditorView[].repricing.groupCode2400 HCP06
serviceLinesEditorView[].repricing.patientGroupAmt2400 HCP07
serviceLinesEditorView[].repricing.productIdQualifier2400 HCP09
serviceLinesEditorView[].repricing.repricedApprHcpcsCode2400 HCP10
serviceLinesEditorView[].repricing.measurementCode2400 HCP11
serviceLinesEditorView[].repricing.serviceUnitCount2400 HCP12
serviceLinesEditorView[].repricing.rejectReasonCode2400 HCP13
serviceLinesEditorView[].repricing.complianceCode2400 HCP14
serviceLinesEditorView[].repricing.exceptionCode2400 HCP15
serviceLinesEditorView[].drugIdentification.productServiceIdQualifier2410 LIN02Written when productServiceIdQualifier and nationalDrugCode are set.
serviceLinesEditorView[].drugIdentification.nationalDrugCode2410 LIN03
serviceLinesEditorView[].drugIdentification.drugQuanity2410 CTP04
serviceLinesEditorView[].drugIdentification.drugQtyUnitOfMeasure2410 CTP05
serviceLinesEditorView[].drugIdentification.prescriptionCompoundDrugNumber.qualifierCode2410 REF*XZ REF01Send XZ.
serviceLinesEditorView[].drugIdentification.prescriptionCompoundDrugNumber.refValue2410 REF*XZ REF02
serviceLinesEditorView[].operatingProvider2420A NM1*72, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as 72.
serviceLinesEditorView[].otherOperatingProvider2420B NM1*ZZ, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as ZZ.
serviceLinesEditorView[].renderingProvider2420C NM1*82, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as 82.
serviceLinesEditorView[].referringProvider2420D NM1*DN, REF (provider)Written when nm1Data.lastName is set. entityCode is filled in as DN.
serviceLinesEditorView[].adjudications[].otherPayerPrimaryIdentifier2430 SVD01One per payer that adjudicated the line. Written only when otherPayerPrimaryIdentifier is set, and it must match that payer's secondaryEditorView[].payerEditorView.payerIdentifier.
serviceLinesEditorView[].adjudications[].serviceLinePaidAmt2430 SVD02
serviceLinesEditorView[].adjudications[].productServiceIdQualifier2430 SVD03-1
serviceLinesEditorView[].adjudications[].procedureCode2430 SVD03-2
serviceLinesEditorView[].adjudications[].modifier12430 SVD03-3
serviceLinesEditorView[].adjudications[].modifier22430 SVD03-4
serviceLinesEditorView[].adjudications[].modifier32430 SVD03-5
serviceLinesEditorView[].adjudications[].modifier42430 SVD03-6
serviceLinesEditorView[].adjudications[].procedureDescription2430 SVD03-7
serviceLinesEditorView[].adjudications[].serviceLineRevenueCode2430 SVD04
serviceLinesEditorView[].adjudications[].paidServiceUnitCount2430 SVD05
serviceLinesEditorView[].adjudications[].bundledLineNumber2430 SVD06
serviceLinesEditorView[].adjudications[].lineAdjustments[]2430 CAS (adjustment)One entry per group code.
serviceLinesEditorView[].adjudications[].dateClaimPaid2430 DTP*573 (date)
serviceLinesEditorView[].adjudications[].amountOwed.amountQualCode2430 AMT*EAF AMT01Filled in as EAF.
serviceLinesEditorView[].adjudications[].amountOwed.monetaryAmt2430 AMT*EAF AMT02

Not sent​

These fields are accepted but do not appear in the 837P. Most belong to institutional or dental claims, which share the same model.

JSON fieldWhy
accountNumberReplaced by the account your credentials resolve to.
claimTypeSet institutional for this page's 837I. Sets GS08 and ST03 when envelop.gs08 is empty.
envelop.isa09ISA09/ISA10 are the time ClaimRev builds the file.
envelop.isa10ISA09/ISA10 are the time ClaimRev builds the file.
envelop.isa11Taken from envelop.separators.
envelop.isa12Always 00501.
envelop.isa16Taken from envelop.separators.
envelop.separatorsSets the delimiters ClaimRev writes with; *, ~, : and ^ when omitted.
claimIdYours to use; not part of the 837.
sharpRcmClaimIdInternal.
claimStatusIdInternal.
claimTextInternal.
claimErrorsOutput only.
receiverViewModelThe receiver (1000B) comes from envelop.receiverName / receiverName.
submitterEditViewModelRequired, but the submitter (1000A) comes from submitterName, submitterId, submitterContactName and submitterPhone.
*.qualifierCodeHintEditor hints.
*.refValueHintEditor hints.
*.otherRefValueHintEditor hints.
*.nm1Data.taxonomyCodeWritten only for the billing (2000A PRV) and attending (2310A PRV) providers.
billingProviderEditorView.secondaryIdentifiers[].otherRefValueNot sent for the billing provider.
payToAddressView.entityCodeAlways 87.
subscriberEditorView.contact1The 837I has no subscriber contact.
patientEditorView.contactThe 837I has no patient contact.
payerEditerView.priorAuthNumberUse claimEditorView.refPriorAuthorization.
payerEditerView.referralNumberUse claimEditorView.refReferralNumber.
payerEditerView.signalCodeOther payers (2330B) only.
payerEditerView.origionalRefNumberUse claimEditorView.refOriginalReference.
payerEditerView.additionalPayerIdentifierOther payers (2330B) only.
payerEditerView.adjudicationPaymentDateOther payers (2330B) only.
payerEditerView.predeterminationOfBenefitsDental (837D) only.
claimEditorView.patientSignatureCodeProfessional (837P) only.
claimEditorView.relatedCausesCode1Professional (837P) only.
claimEditorView.relatedCausesCode2Professional (837P) only.
claimEditorView.accidentStateProfessional (837P) only.
claimEditorView.accidentCountryProfessional (837P) only.
claimEditorView.specialProgramIndicatorProfessional (837P) only.
claimEditorView.claimSubmissionReasonCodeDental (837D) only.
claimEditorView.dateOnSetOfCurrentIllnessProfessional (837P) only.
claimEditorView.dateLastXRayProfessional (837P) only.
claimEditorView.dateInitialTreatmentProfessional (837P) only.
claimEditorView.dateHearingVisionRxProfessional (837P) only.
claimEditorView.dateStartAssumedRelinqishedProfessional (837P) only.
claimEditorView.dateEndAssumedRelinqishedProfessional (837P) only.
claimEditorView.dateLastSeenProfessional (837P) only.
claimEditorView.dateDisabilityProfessional (837P) only.
claimEditorView.dateDisabilityStartProfessional (837P) only.
claimEditorView.dateDisabilityEndProfessional (837P) only.
claimEditorView.dateAcuteManifestationProfessional (837P) only.
claimEditorView.dateLastWorkedProfessional (837P) only.
claimEditorView.datePropertyCasualtyProfessional (837P) only.
claimEditorView.dateAccidentProfessional (837P) only.
claimEditorView.dateAuthorizedReturnWorkProfessional (837P) only.
claimEditorView.dateLastMenstrualProfessional (837P) only.
claimEditorView.appliancePlacementDental (837D) only.
claimEditorView.serviceDates of service are per line (serviceLinesEditorView[].dateService); the statement period is dateStatementDate.
claimEditorView.refPredeterminationOfBenefitsIdentDental (837D) only.
claimEditorView.refSpecialPaymentProfessional (837P) only.
claimEditorView.refClinicalLabImprovementProfessional (837P) only.
claimEditorView.refFacilityIdNumberProfessional (837P) only.
claimEditorView.refMedicareVersionCodeProfessional (837P) only.
claimEditorView.refMammographyCertNumberProfessional (837P) only.
claimEditorView.note.referenceCodeAlways ADD for note.
claimEditorView.ambulanceTransportProfessional (837P) only.
claimEditorView.spinalManipulationProfessional (837P) only.
claimEditorView.ambulanceCertsProfessional (837P) only.
claimEditorView.visionCertsProfessional (837P) only.
claimEditorView.homeBoundProfessional (837P) only.
claimEditorView.epsdt.codeCategoryAlways ZZ.
claimEditorView.diagnosisCodes[].diagnosisOrderOrder 1 is the principal diagnosis; the rest are sorted by it.
claimEditorView.diagnosisCodes[].procedureDateNot used for diagnoses.
claimEditorView.diagnosisCodes[].monitaryAmountNot used for diagnoses.
claimEditorView.admittingDiagnosisCode.diagnosisOrderNot used.
claimEditorView.admittingDiagnosisCode.presentOnAdmissionNot used for the admitting diagnosis.
claimEditorView.admittingDiagnosisCode.procedureDateNot used.
claimEditorView.admittingDiagnosisCode.monitaryAmountNot used.
claimEditorView.reasonForVisitDiagnosisCodes[].diagnosisOrderSets the order of the composites.
claimEditorView.reasonForVisitDiagnosisCodes[].presentOnAdmissionNot used for reason for visit.
claimEditorView.reasonForVisitDiagnosisCodes[].procedureDateNot used.
claimEditorView.reasonForVisitDiagnosisCodes[].monitaryAmountNot used.
claimEditorView.externalCauseInjDiagnosisCodes[].diagnosisOrderSets the order of the composites.
claimEditorView.externalCauseInjDiagnosisCodes[].procedureDateNot used.
claimEditorView.externalCauseInjDiagnosisCodes[].monitaryAmountNot used.
claimEditorView.principalProcedureCode.diagnosisOrderNot used.
claimEditorView.principalProcedureCode.presentOnAdmissionNot used for procedures.
claimEditorView.principalProcedureCode.monitaryAmountNot used.
claimEditorView.otherPrincipalProcedureCodes[].diagnosisOrderSets the order of the composites.
claimEditorView.otherPrincipalProcedureCodes[].presentOnAdmissionNot used for procedures.
claimEditorView.otherPrincipalProcedureCodes[].monitaryAmountNot used.
claimEditorView.occurrenceSpanCodes[].diagnosisOrderSets the order of the composites.
claimEditorView.occurrenceSpanCodes[].presentOnAdmissionNot used.
claimEditorView.occurrenceSpanCodes[].monitaryAmountNot used.
claimEditorView.occurrenceCodes[].diagnosisOrderSets the order of the composites.
claimEditorView.occurrenceCodes[].presentOnAdmissionNot used.
claimEditorView.occurrenceCodes[].monitaryAmountNot used.
claimEditorView.valueInformation[].diagnosisOrderSets the order of the composites.
claimEditorView.valueInformation[].presentOnAdmissionNot used.
claimEditorView.valueInformation[].procedureDateNot used.
claimEditorView.anesthesaProcedureCodeProfessional (837P) only.
claimEditorView.anesthesaIndustryCodeProfessional (837P) only.
claimEditorView.repricing.productIdQualifierLine-level only (HCP09).
claimEditorView.repricing.repricedApprHcpcsCodeLine-level only (HCP10).
claimEditorView.repricing.measurementCodeLine-level only (HCP11).
claimEditorView.repricing.serviceUnitCountLine-level only (HCP12).
claimEditorView.primaryCareProviderProfessional (837P) only.
claimEditorView.supervisingProviderProfessional (837P) only.
claimEditorView.assistantSurgeonDental (837D) only.
claimEditorView.ambulancePickupLocationProfessional (837P) only.
claimEditorView.ambulanceDropOffLocationProfessional (837P) only.
claimEditorView.orthoTotalMonthsTreatmentDental (837D) only.
claimEditorView.toothStatusesDental (837D) only.
secondaryEditorView[].otherSubscriber.insuranceTypeCodeNot used in 2320 SBR.
secondaryEditorView[].otherSubscriber.dateOfDeathNot part of 2330A.
secondaryEditorView[].otherSubscriber.measurementCodeNot part of 2330A.
secondaryEditorView[].otherSubscriber.weightNot part of 2330A.
secondaryEditorView[].otherSubscriber.pregnancyIndicatorNot part of 2330A.
secondaryEditorView[].otherSubscriber.birthDayNot part of 2330A.
secondaryEditorView[].otherSubscriber.genderNot part of 2330A.
secondaryEditorView[].otherSubscriber.casualtyClaimNumberNot part of 2330A.
secondaryEditorView[].otherSubscriber.contact1Not part of 2330A.
secondaryEditorView[].patientSignatureCodeProfessional (837P) only.
secondaryEditorView[].payerEditorView.providerCommericalNumberA billing-provider id (2010BB); not valid for another payer (2330B).
secondaryEditorView[].payerEditorView.locationNumberA billing-provider id (2010BB); not valid for another payer (2330B).
secondaryEditorView[].payerEditorView.predeterminationOfBenefitsDental (837D) only.
secondaryEditorView[].payerEditorView.adjudicationPaymentDate.periodFormatAlways D8.
secondaryEditorView[].serviceFacility.address12330F carries the name and ids only.
secondaryEditorView[].serviceFacility.address22330F carries the name and ids only.
secondaryEditorView[].serviceFacility.city2330F carries the name and ids only.
secondaryEditorView[].serviceFacility.state2330F carries the name and ids only.
secondaryEditorView[].serviceFacility.zip2330F carries the name and ids only.
secondaryEditorView[].primaryCareProviderProfessional (837P) only.
secondaryEditorView[].supervisingProviderProfessional (837P) only.
secondaryEditorView[].assistantSurgeonDental (837D) only.
secondaryEditorView[].billingProviderEditorView.address12330I carries the name and ids only.
secondaryEditorView[].billingProviderEditorView.address22330I carries the name and ids only.
secondaryEditorView[].billingProviderEditorView.city2330I carries the name and ids only.
secondaryEditorView[].billingProviderEditorView.state2330I carries the name and ids only.
secondaryEditorView[].billingProviderEditorView.zip2330I carries the name and ids only.
secondaryEditorView[].billingProviderEditorView.contact12330I carries the name and ids only.
secondaryEditorView[].billingProviderEditorView.contact22330I carries the name and ids only.
serviceLinesEditorView[].placeOfServiceProfessional (837P) only.
serviceLinesEditorView[].oralCavityDesignationCode1Dental (837D) only.
serviceLinesEditorView[].oralCavityDesignationCode2Dental (837D) only.
serviceLinesEditorView[].oralCavityDesignationCode3Dental (837D) only.
serviceLinesEditorView[].oralCavityDesignationCode4Dental (837D) only.
serviceLinesEditorView[].oralCavityDesignationCode5Dental (837D) only.
serviceLinesEditorView[].prosthesisCrownInlayCodeDental (837D) only.
serviceLinesEditorView[].procedureCountDental (837D) only.
serviceLinesEditorView[].pointer1Professional (837P) only.
serviceLinesEditorView[].pointer2Professional (837P) only.
serviceLinesEditorView[].pointer3Professional (837P) only.
serviceLinesEditorView[].pointer4Professional (837P) only.
serviceLinesEditorView[].emergencyIndicatorProfessional (837P) only.
serviceLinesEditorView[].epsdtIndicatorProfessional (837P) only.
serviceLinesEditorView[].familyIndicatorProfessional (837P) only.
serviceLinesEditorView[].coPayStatusCodeProfessional (837P) only.
serviceLinesEditorView[].dmeServiceProfessional (837P) only.
serviceLinesEditorView[].teethInformationDental (837D) only.
serviceLinesEditorView[].dmeCertOfMedicalNecessityIndicatorProfessional (837P) only.
serviceLinesEditorView[].ambulanceTransportProfessional (837P) only.
serviceLinesEditorView[].durableMedicalEquipmentCertProfessional (837P) only.
serviceLinesEditorView[].ambulanceCertsProfessional (837P) only.
serviceLinesEditorView[].hospiceIndicatorProfessional (837P) only.
serviceLinesEditorView[].dmeConditionProfessional (837P) only.
serviceLinesEditorView[].datePrescriptionProfessional (837P) only.
serviceLinesEditorView[].dateCertificationRevisionRecertProfessional (837P) only.
serviceLinesEditorView[].dateBeginTherapyProfessional (837P) only.
serviceLinesEditorView[].dateLastCertificationProfessional (837P) only.
serviceLinesEditorView[].dateLastSeenProfessional (837P) only.
serviceLinesEditorView[].dateRecentHemoglobinProfessional (837P) only.
serviceLinesEditorView[].dateRecentSerumCreatineProfessional (837P) only.
serviceLinesEditorView[].dateShippedProfessional (837P) only.
serviceLinesEditorView[].dateLastXRayProfessional (837P) only.
serviceLinesEditorView[].dateInitialTreatmentProfessional (837P) only.
serviceLinesEditorView[].dateEstimatedPriorPlacementDental (837D) only.
serviceLinesEditorView[].datePriorPlacementDental (837D) only.
serviceLinesEditorView[].dateAppliancePlacementDental (837D) only.
serviceLinesEditorView[].dateApplianceReplacementDental (837D) only.
serviceLinesEditorView[].dateTreatmentStartDental (837D) only.
serviceLinesEditorView[].dateTreatmentEndDental (837D) only.
serviceLinesEditorView[].ambulancePatientCountProfessional (837P) only.
serviceLinesEditorView[].obstretricAnesthesiaAddUnitsProfessional (837P) only.
serviceLinesEditorView[].testResultsProfessional (837P) only.
serviceLinesEditorView[].contractInfoNot used at line level in 837I.
serviceLinesEditorView[].refPriorAuthorizationNot used at line level in 837I.
serviceLinesEditorView[].refPredeterminationOfBenefitsIdentDental (837D) only.
serviceLinesEditorView[].refRepricedClaimRefNumberNot used at line level.
serviceLinesEditorView[].refAdjRepricedClaimRefNumberNot used at line level.
serviceLinesEditorView[].refMammographyCertNumberProfessional (837P) only.
serviceLinesEditorView[].refCliaNumberProfessional (837P) only.
serviceLinesEditorView[].refCliaNumberFacilityIdentProfessional (837P) only.
serviceLinesEditorView[].refImmunizationBatchNumberProfessional (837P) only.
serviceLinesEditorView[].refReferralNumberNot used at line level in 837I.
serviceLinesEditorView[].salesTaxAmount.amountQualCodeAlways GT.
serviceLinesEditorView[].postageClaimedAmt.amountQualCodeAlways N8.
serviceLinesEditorView[].serviceTaxAmountUse salesTaxAmount, written as AMT*GT.
serviceLinesEditorView[].miscTaxesUse postageClaimedAmt, written as AMT*N8.
claimEditorView.patientPaidAmount.qualifierCodeAlways F3.
serviceLinesEditorView[].fileInformationsNot used at line level in 837I.
serviceLinesEditorView[].lineNoteProfessional (837P) only.
serviceLinesEditorView[].purchasedServiceInfoProfessional (837P) only.
serviceLinesEditorView[].drugIdentification.prescriptionCompoundDrugNumber.otherRefValueNot sent.
serviceLinesEditorView[].purchasedServiceProviderProfessional (837P) only.
serviceLinesEditorView[].assistantSurgeonDental (837D) only.
serviceLinesEditorView[].serviceFacilityNot used at line level in 837I.
serviceLinesEditorView[].supervisingProviderProfessional (837P) only.
serviceLinesEditorView[].orderingProviderProfessional (837P) only.
serviceLinesEditorView[].primaryCareProviderProfessional (837P) only.
serviceLinesEditorView[].ambulancePickupLocationProfessional (837P) only.
serviceLinesEditorView[].ambulanceDropOffLocationProfessional (837P) only.
serviceLinesEditorView[].formIdentProfessional (837P) only.
serviceLinesEditorView[].adjudications[].modifier5SVD03 carries four modifiers.
serviceLinesEditorView[].adjudications[].dateClaimPaid.periodFormatAlways D8.