This document maps API request fields to the ASC X12N 005010X211 transaction.
It is not applicable to ASC X12N 005010X210 claim attachment transactions unless explicitly stated.
This document describes how the Prior Authorization Attachment Submission API JSON request is translated into an ASC X12N 005010X211 (275) transaction. Please see Understanding JSON-to-EDI API Mapping .
The X211 implementation guide specifically supports Health Care Services Review workflows rather than claim adjudication workflows.
The mapping includes:
JSON field
EDI Loop
EDI Segment
Element Number
X12 Description
Usage
Sample Value
Business Context
The transaction hierarchy below follows the ASC X12N 005010X211 implementation guide.
Transaction Hierarchy
1000A Information Source
NM1
PER
1000B Information Receiver
NM1
1000C Patient
NM1
REF
2000A Attachment Detail
LX
TRN
STC
REF
2100A Additional Information
DTP
CAT
2110A Attachment Content
EFI
BIN
Transaction Hierarchy
ISA
└── GS
└── ST
├── BGN
├── 1000A Information Source
├── 1000B Information Receiver
├── 1000C Patient
├── 2000A Attachment Detail
│ └── 2100A Additional Information
│ └── 2110A Attachment Content
└── SE
JSON Field Loop Segment Element Required Example senderIdISA ISA06 Interchange Sender ID Y SUBMITTER01 receiverIdISA ISA08 Interchange Receiver ID Y UHC interchangeDateISA ISA09 Date Y 260825 interchangeTimeISA ISA10 Time Y 1130
JSON Field Segment Element Example functionalGroupSenderGS GS02 SUBMITTER01 functionalGroupReceiverGS GS03 UHC controlNumberGS GS06 12345
JSON Field Segment Element Example transactionSetControlNumberST ST02 0001
JSON Field Segment Element Example purposeCodeBGN01 Purpose Code 11 referenceNumberBGN02 Reference Number PA12345 createdDateBGN03 Date 20260825 createdTimeBGN04 Time 113000
📘 NOTE
Not every API field becomes an EDI segment. The 275X211 payload contains only the data required to support a health care services review request. API transport metadata (headers, correlation identifiers, timestamps, environment indicators, pagination attributes, etc.) are used by the API platform and are not included in the generated X12 transaction.
Submitting Provider/Dental Office
TJSON Structure
{
"informationSource": {
"organizationName": "ABC Dental",
"npi": "1234567890",
"contactName": "John Smith",
"phone": "8005551212"
}
}
JSON Path Loop Segment Element Description informationSource.organizationName1000A NM103 Name Last/Organization Provider Name informationSource.npi1000A NM109 Identification Code Provider NPI informationSource.contactName1000A PER02 Contact Name Technical Contact informationSource.phone1000A PER04 Communication Number Phone
Example - EDI is not fully supported, syntax highlighted is based on JSON
NM1*1P*2*ABC DENTAL*****XX*1234567890~
PER*IC*JOHN SMITH*TE*8005551212~
Receiving Health Plan
JSON Structure
{
"informationReceiver": {
"organizationName": "UnitedHealthcare",
"payerId": "87726"
}
}
JSON Path Loop Segment Element informationReceiver.organizationName1000B NM103 Organization Name informationReceiver.payerId1000B NM109 Payer Identifier
Example - EDI is not fully supported, syntax highlighted is based on JSON
NM1*PR*2*UNITEDHEALTHCARE*****PI*87726~
JSON Structure
{
"patient": {
"memberId": "987654321",
"lastName": "DOE",
"firstName": "JANE",
"accountNumber": "12345"
}
}
JSON Path Loop Segment Qualifier Element patient.memberId1000C NM1 NM109 Member Identifier patient.lastName1000C NM103 Last Name patient.firstName1000C NM104 First Name patient.accountNumber1000C REF EJ Account Number patient.eventTrackingNumber1000C REF 2I Event Tracking
Example - EDI is not fully supported, syntax highlighted is based on JSON
NM1*QC*1*DOE*JANE****MI*987654321~
REF*EJ*12345~
Field 275X210 275X211 claimNumber✓ claimControlNumber✓ priorAuthorizationNumber✓ serviceReviewTrackingNumber✓ diagnosisCode✓ ✓ procedureCode✓ ✓ attachmentControlNumber✓ ✓ attachmentContent✓ ✓
API Field Loop Segment attachmentTrackingNumber2000A TRN02 diagnosisCode2000A REF(ICD) procedureCode2000A REF(CPT) loincCode2000A STC01-02
Repeatable Loop
Each document submission generates a separate Loop 2000A instance.
JSON Field Segment Element sequenceNumberLX LX01
Example (EDI not supported)
JSON Field Segment Element attachmentControlNumberTRN TRN02
Example - EDI is not fully supported, syntax highlighted is based on JSON
LOINC-driven identification for requested documentation.
JSON Path EDI Composite Example loincCodeSTC01-02 27685-7 codeSourceSTC01-04 LOI
Example - EDI is not fully supported, syntax highlighted is based on JSON
Common Prior Authorization LOINC values :
LOINC Description 27685-7 Dental Narrative 11504-8 Diagnostic Report Payer Defined Additional Medical Necessity Documentation
JSON Field REF01 REF02 diagnosisCodeICD K08.89
Example - EDI is not fully supported, syntax highlighted is based on JSON
JSON Field REF01 REF02 procedureCodeCPT D4341
Example - EDI is not fully supported, syntax highlighted is based on JSON
JSON Field REF01 REF02 serviceTraceNumberFJ ABC123
Example - EDI is not fully supported, syntax highlighted is based on JSON
JSON Field Segment Element submissionDateDTP DTP03
Example (EDI not fully supported)
JSON Field Segment Element attachmentTypeCAT CAT02
Example - EDI is not fully supported, syntax highlighted is based on JSON
Valid values
Value Description IA Image HL HL7 CDA MB MIME Binary TX Text
JSON Field Segment Element fileFormatCodeEFI EFI01
Example - EDI is not fully supported, syntax highlighted is based on JSON
JSON Field Segment Element byteCountBIN BIN01 contentBIN BIN02
Example - EDI is not fully supported, syntax highlighted is based on JSON
BIN*10240*JVBERi0xLjQK...~
The BIN segment contains the actual attachment payload (PDF, TIFF, JPEG, CDA XML, etc.).
Prior Authorization Example
ST*275*0003*005010X211~
BGN*11*99999*20240618~
NM1*X3*2*OPTUM UMO*****24*987654321~
NM1*IL*1*DOE*MARK****MI*444555666~
REF*EJ*PATIENTACC123~
LX*1~
TRN*2*UMOCTRL001~
STC*R4:11504-8::LOI~
REF*FJ*LINE1~
REF*CPT*27447~
DTP*368*D8*20240618~
CAT*AE*HL~
EFI*05~
BIN*150*VGhpcyBpcyBhIHNhbXBsZSBwYXlsb2Fk~
SE*14*0003~
``
Example JSON
{
"attachmentControlNumber": "PA123456",
"memberId": "987654321",
"diagnosisCode": "K08.89",
"procedureCode": "D4341",
"loincCode": "27685-7",
"submissionDate": "20260825",
"attachmentType": "IA",
"file": {
"byteCount": 5000,
"content": "<base64-encoded-document>"
}
}
Example 275x211 - EDI is not fully supported, syntax highlighted is based on JSON
ST*275*0003*005010X211~
BGN*11*99999*20240618~
NM1*X3*2*OPTUM UMO*****24*987654321~
NM1*IL*1*DOE*MARK****MI*444555666~
REF*EJ*PATIENTACC123~
LX*1~
TRN*2*UMOCTRL001~
STC*R4:11504-8::LOI~
REF*FJ*LINE1~
REF*CPT*27447~
DTP*368*D8*20240618~
CAT*AE*HL~
EFI*05~
BIN*150*VGhpcyBpcyBhIHNhbXBsZSBwYXlsb2Fk~
SE*14*0003~
Loop Purpose Repeat 1000A Information Source (Provider) No 1000B Information Receiver (Payer) No 1000C Patient Information No 2000A Attachment Detail Yes 2100A Date/Attachment Metadata Yes (within 2000A) 2110A Attachment Content Yes (within 2100A)
For more information, please refer to 275 Additional Information to Support a Health Care Services Review_5010X211 3.pdf .
API Request Field JSON Path 275 Loop Segment Element Notes Information Source NPI informationSource.npi1000A NM1 NM109 Provider Identifier Information Source Name informationSource.name1000A NM1 NM103 Submitting Provider Information Source Contact Name informationSource.contactName1000A PER PER02 Optional Information Source Phone informationSource.phone1000A PER PER04 Optional
Example
{
"informationSource": {
"npi": "1234567890",
"name": "ABC Dental"
}
}
Maps to
Example - EDI is not fully supported, syntax highlighted is based on JSON
NM1*1P*2*ABC DENTAL*****XX*1234567890~
API Field JSON Path Loop Segment Element Payer ID payer.id1000B NM109 Receiver Identifier Payer Name payer.name1000B NM103 Receiver Name
Example
{
"payer": {
"id": "87726",
"name": "UnitedHealthcare"
}
}
Maps to
Example - EDI is not fully supported, syntax highlighted is based on JSON
NM1*PR*2*UNITEDHEALTHCARE*****PI*87726~
API Field JSON Path Loop Segment Element Member ID patient.memberId1000C NM109 Subscriber Identifier Last Name patient.lastName1000C NM103 Patient Last Name First Name patient.firstName1000C NM104 Patient First Name Patient Account Number patient.accountNumber1000C REF*EJ REF02 Event Tracking Number patient.eventTrackingNumber1000C REF*2I REF02
priorAuthorizationNumber
attachmentControlNumber
serviceReviewTrackingNumber
diagnosisCode
procedureCode
attachmentType
document content
x-optum-consumer-correlation-id
requestId
environment
timestamp
gateway identifiers
API Field X211 Location X210 Equivalent Comments priorAuthorizationNumberTRN02 or REF02 (implementation specific) N/A Verify against API payload and generated X12 attachmentControlNumber2000A/TRN02 2000A/TRN02 Common to both claimNumberN/A REF segment in X210 workflows Usually absent from X211 serviceReviewTrackingNumber2000A/TRN02 N/A X211-specific 278 Request Identifier TRN02 or REF02 N/A Used to correlate the 275 attachment to the originating 278 request
API Field Purpose 275X211 Mapping X12 Transmitted trackingNumberDepends on implementation TRN02 (if used as attachment control number) Conditional attachmentControlNumberAttachment identifier 2000A/TRN02 Yes serviceReviewTrackingNumberPrior auth correlation 2000A/TRN02 Yes priorAuthorizationNumberVerify actual X12 output TRN02 or REF02 (payer-specific) Yes x-optum-consumer-correlation-idAPI gateway tracing only N/A No environmentAPI routing metadata N/A No
📘 NOTE
The mapping of trackingNumber depends on the API implementation.
If the field serves as the attachment control number, it is mapped to TRN02.
If the field is used solely for API transaction tracking, it is not included in the 275 transaction.
Field Category Examples Sent to 275X211 Business Data Member ID, Diagnosis Code, Procedure Code, Prior Authorization Number Yes Attachment Data LOINC, Attachment Type, PDF Content Yes Attachment Correlation Attachment Tracking Number Yes API Metadata Correlation ID, Environment No Gateway Metadata Request ID, Trace ID, Timestamp No
API Field JSON Path Loop Segment Element Business Meaning Diagnosis Code diagnosisCode2000A REF*ICD REF02 Procedure Code procedureCode2000A REF*CPT REF02 Service Trace Number serviceTraceNumber2000A REF*FJ REF02 LOINC Code loincCode2000A STC01-02 Requested Documentation Type
Example
{
"diagnosisCode": "K08.89",
"*rocedureCode": "D4341",
"loincCo*e": "27685-7"
}
Maps to
Example - EDI is not fully supported, syntax highlighted is based on JSON
*TC*R4:27685-7::LOI~
REF**CD*K08.89~
REF*CPT*D4341~
API Field JSON Path Loop Segment Element Submission Date submissionDate2100A DTP03 Date Additional Info Submitted Attachment Type attachmentType2100A CAT02 Image/PDF/CDA Indicator File Format Code fileFormatCode2110A EFI01 File Type MIME Type mimeType2110A EFI Documentation only
API Field JSON Path Loop Segment Element Document Byte Count document.byteCount2110A BIN01 Binary Length Base64 Attachment document.content2110A BIN02 Actual Attachment Data PDF Document document.content2110A BIN02 PDF Payload TIFF Image document.content2110A BIN02 TIFF Payload JPEG Image document.content2110A BIN02 JPEG Payload
API Field X12 Mapping Reason x-optum-consumer-correlation-idNone API transaction tracing requestIdNone API response correlation environmentNone Gateway routing receivedTimestampNone System metadata nextPageTokenNone Pagination support
📘 NOTE
Not every API field becomes an EDI segment. The 275X211 payload contains only the data required to support a health care services review request. API transport metadata (headers, correlation identifiers, timestamps, environment indicators, pagination attributes, etc.) are used by the API platform and are not included in the generated X12 transaction.
API Field Loop ID Segment Element ID Qualifier Element Name Req X12 Usage/Type Description Example informationSource.name1000A NM1 NM103 1P Name Last or Organization Name Y Required/String Submitting provider name ABC Dental informationSource.npi1000A NM1 NM109 XX Identification Code Y Required/String Provider NPI 1234567890 informationSource.contactName1000A PER PER02 IC Contact Name N Situational/String Provider contact John Smith informationSource.contactPhone1000A PER PER04 TE Communication Number N Situational/String Contact phone 8005551212
X12 Example - EDI is not fully supported, syntax highlighted is based on plain text
NM1*1P*2*ABC DENTAL*****XX*1234567890~
PER*IC*JOHN SMITH*TE*8005551212~
API Field Loop ID Segment Element ID Element Name Req X12 Usage/Type Description Example payer.name1000B NM1 NM103 Organization Name Y Required/String Receiving payer UnitedHealthcare payer.id1000B NM1 NM109 Identification Code Y Required/String Payer identifier 87726
X12 Example - EDI is not fully supported, syntax highlighted is based on plain text
NM1*PR*2*UNITEDHEALTHCARE*****PI*87726~
API Field Loop ID Segment Element ID Element Name Req X12 Usage/Type Description Example patient.memberId1000C NM1 NM109 Identification Code Y Required/String Member ID 987654321 patient.lastName1000C NM1 NM103 Patient Last Name Y Required/String Patient surname Doe patient.firstName1000C NM1 NM104 Patient First Name Y Required/String Patient given name Jane patient.accountNumber1000C REF REF02 Reference Identification N Situational/String Patient account number 12345 patient.eventTrackingNumber1000C REF REF02 Reference Identification N Situational/String Event tracking number EVT12345
X12 Example - EDI is not fully supported, syntax highlighted is based on plain text
NM1*QC*1*DOE*JANE****MI*987654321~
REF*EJ*12345~
REF*2I*EVT12345~
API Field Loop ID Segment Element Qualifier X12 Element Name X12 Usage Required Sample Value Description attachmentControlNumber2000A TRN TRN02 N/A Reference Identification Required Y ATT123456 Attachment tracking identifier priorAuthorizationNumber2000A TRN/REF TRN02 / REF02 Implementation Specific Reference Identification Situational Y PA987654 Prior authorization identifier serviceReviewTrackingNumber2000A TRN TRN02 N/A Reference Identification Situational N SR123456 Service review tracking identifier loincCode2000A STC STC01-02 LOI Industry Code Required Y 27685-7 Requested attachment type diagnosisCode2000A REF REF02 ICD Reference Identification Situational N K08.89 Diagnosis code procedureCode2000A REF REF02 CPT Reference Identification Situational N D4341 Procedure code serviceTraceNumber2000A REF REF02 FJ Reference Identification Situational N ABC123 Service trace number
EDI is not fully supported, syntax highlighted is based on plain text
LX*1~
TRN*2*ATT123456~
STC*R4:27685-7::LOI~
REF*ICD*K08.89~
REF*CPT*D4341~
REF*FJ*ABC123~
API Field Loop ID Segment Element ID Element Name Req X12 Usage/Type Description Example submissionDate2100A DTP DTP03 Date Time Period Y Required/Date Date submitted 20260825 attachmentType2100A CAT CAT02 Category Code Y Required/String Attachment format IA
CAT02 Description IA Image Attachment HL HL7 CDA MB MIME Binary TX Text
EDI is not fully supported, syntax highlighted is based on plain text
DTP*368*D8*20260825~
CAT*AE*IA~
API Field Loop ID Segment Element ID Element Name Req X12 Usage/Type Description Example fileFormatCode2110A EFI EFI01 External File Information Code Y Required/String File format indicator 05 document.byteCount2110A BIN BIN01 Binary Data Length Y Required/Integer Attachment size 5000 document.content2110A BIN BIN02 Binary Data Y Required/Base64 Encoded attachment JVBERi0xLjQK
EDI is not fully supported, syntax highlighted is based on plain text
EFI*05~
BIN*5000*JVBERi0xLjQK...~
Area 275X210 275X211 Business Purpose Additional Information to Support a Claim Additional Information to Support a Health Care Services Review (Prior Auth) Related Transaction 837 Claim 278 Prior Authorization Attachment Tracking Claim-centric Authorization-centric LOINC Usage Attachment for claim adjudication Attachment for utilization review/prior auth Patient Context Claim submission Service review request Reference Numbers Claim identifiers Prior authorization/request identifiers Common Workflow 837 → 275X210 278 → 275X211