275X211 Prior Authorization JSON-to-EDI Mapping

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.

Overview

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.

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
ISA
└── GS
    └── ST
        ├── BGN
        ├── 1000A Information Source
        ├── 1000B Information Receiver
        ├── 1000C Patient
        ├── 2000A Attachment Detail
        │     └── 2100A Additional Information
        │            └── 2110A Attachment Content
        └── SE

Envelope mapping

ISA interchange control header

JSON FieldLoopSegmentElementRequiredExample
senderIdISAISA06Interchange Sender IDYSUBMITTER01
receiverIdISAISA08Interchange Receiver IDYUHC
interchangeDateISAISA09DateY260825
interchangeTimeISAISA10TimeY1130

GS functional group

JSON FieldSegmentElementExample
functionalGroupSenderGSGS02SUBMITTER01
functionalGroupReceiverGSGS03UHC
controlNumberGSGS0612345

ST transaction set

JSON FieldSegmentElementExample
transactionSetControlNumberSTST020001

BGN beginning segment

JSON FieldSegmentElementExample
purposeCodeBGN01Purpose Code11
referenceNumberBGN02Reference NumberPA12345
createdDateBGN03Date20260825
createdTimeBGN04Time113000

📘

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.

Loop 1000A Information Source Name

Submitting Provider/Dental Office

JSON Structure

{
  "informationSource": {
    "organizationName": "ABC Dental",
    "npi": "1234567890",
    "contactName": "John Smith",
    "phone": "8005551212"
  }
}

EDI mapping

JSON PathLoopSegmentElementDescription
informationSource.organizationName1000ANM103Name Last/OrganizationProvider Name
informationSource.npi1000ANM109Identification CodeProvider NPI
informationSource.contactName1000APER02Contact NameTechnical Contact
informationSource.phone1000APER04Communication NumberPhone
NM1*1P*2*ABC DENTAL*****XX*1234567890~
PER*IC*JOHN SMITH*TE*8005551212~

Loop 1000B Information Receiver Name

Receiving Health Plan

JSON structure

{
  "informationReceiver": {
    "organizationName": "UnitedHealthcare",
    "payerId": "87726"
  }
}

EDI mapping

JSON PathLoopSegmentElement
informationReceiver.organizationName1000BNM103Organization Name
informationReceiver.payerId1000BNM109Payer Identifier
NM1*PR*2*UNITEDHEALTHCARE*****PI*87726~

Loop 1000C Patient Name

JSON structure

{
  "patient": {
    "memberId": "987654321",
    "lastName": "DOE",
    "firstName": "JANE",
    "accountNumber": "12345"
  }
}

Mapping

JSON PathLoopSegmentQualifierElement
patient.memberId1000CNM1NM109Member Identifier
patient.lastName1000CNM103Last Name
patient.firstName1000CNM104First Name
patient.accountNumber1000CREFEJAccount Number
patient.eventTrackingNumber1000CREF2IEvent Tracking
NM1*QC*1*DOE*JANE****MI*987654321~
REF*EJ*12345~

Transaction type applicability

Field275X210275X211
claimNumber✓
claimControlNumber✓
priorAuthorizationNumber✓
serviceReviewTrackingNumber✓
diagnosisCode✓✓
procedureCode✓✓
attachmentControlNumber✓✓
attachmentContent✓✓

Loop 2000A Attachment Information Detail

API FieldLoopSegment
attachmentTrackingNumber2000ATRN02
diagnosisCode2000AREF(ICD)
procedureCode2000AREF(CPT)
loincCode2000ASTC01-02

Repeatable Loop

Each document submission generates a separate Loop 2000A instance.

LX Assigned Number

JSON FieldSegmentElement
sequenceNumberLXLX01
LX*1~

TRN Trace Number

JSON FieldSegmentElement
attachmentControlNumberTRNTRN02
TRN*2*PA123456~

STC Status Information

LOINC-driven identification for requested documentation.

JSON PathEDI CompositeExample
loincCodeSTC01-0227685-7
codeSourceSTC01-04LOI
STC*R4:27685-7::LOI~

Common Prior Authorization LOINC values:

LOINCDescription
27685-7Dental Narrative
11504-8Diagnostic Report
Payer DefinedAdditional Medical Necessity Documentation

REF Diagnostics

JSON FieldREF01REF02
diagnosisCodeICDK08.89
REF*ICD*K08.89~

REF Procedure

JSON FieldREF01REF02
procedureCodeCPTD4341
REF*CPT*D4341~

REF Service Trace Number

JSON FieldREF01REF02
serviceTraceNumberFJABC123
REF*FJ*ABC123~

Loop 2100A Additional Information

DTP

JSON FieldSegmentElement
submissionDateDTPDTP03
DTP*368*D8*20260825~

CAT Attachment Information

JSON FieldSegmentElement
attachmentTypeCATCAT02
CAT*AE*IA~

Valid values

ValueDescription
IAImage
HLHL7 CDA
MBMIME Binary
TXText

Loop 2110A Attachment Content

EFI External File Information

JSON FieldSegmentElement
fileFormatCodeEFIEFI01
EFI*05~

BIN Binary Payload

JSON FieldSegmentElement
byteCountBINBIN01
contentBINBIN02
BIN*10240*JVBERi0xLjQK...~

The BIN segment contains the actual attachment payload (PDF, TIFF, JPEG, CDA XML, etc.).

Prior Authorization Attachment (275 — X211)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~
``

API JSON

{
  "attachmentControlNumber": "PA123456",
  "memberId": "987654321",
  "diagnosisCode": "K08.89",
  "procedureCode": "D4341",
  "loincCode": "27685-7",
  "submissionDate": "20260825",
  "attachmentType": "IA",
  "file": {
    "byteCount": 5000,
    "content": "<base64-encoded-document>"
  }
}

Generated 275x211

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 summary

LoopPurposeRepeat
1000AInformation Source (Provider)No
1000BInformation Receiver (Payer)No
1000CPatient InformationNo
2000AAttachment DetailYes
2100ADate/Attachment MetadataYes (within 2000A)
2110AAttachment ContentYes (within 2100A)

For more information, please refer to 275 Additional Information to Support a Health Care Services Review_5010X211 3.pdf.

API Request Field → 275X211 Loop Crosswalk

Information source (Provider)

API Request FieldJSON Path275 LoopSegmentElementNotes
Information Source NPIinformationSource.npi1000ANM1NM109Provider Identifier
Information Source NameinformationSource.name1000ANM1NM103Submitting Provider
Information Source Contact NameinformationSource.contactName1000APERPER02Optional
Information Source PhoneinformationSource.phone1000APERPER04Optional
{
  "informationSource": {
    "npi": "1234567890",
    "name": "ABC Dental"
  }
}

Maps to

NM1*1P*2*ABC DENTAL*****XX*1234567890~

Payer information

API FieldJSON PathLoopSegmentElement
Payer IDpayer.id1000BNM109Receiver Identifier
Payer Namepayer.name1000BNM103Receiver Name
{
  "payer": {
    "id": "87726",
    "name": "UnitedHealthcare"
  }
}

Maps to

NM1*PR*2*UNITEDHEALTHCARE*****PI*87726~

Patient information

API FieldJSON PathLoopSegmentElement
Member IDpatient.memberId1000CNM109Subscriber Identifier
Last Namepatient.lastName1000CNM103Patient Last Name
First Namepatient.firstName1000CNM104Patient First Name
Patient Account Numberpatient.accountNumber1000CREF*EJREF02
Event Tracking Numberpatient.eventTrackingNumber1000CREF*2IREF02

Prior Authorization information

Business data (sent to X12)

  • priorAuthorizationNumber
  • attachmentControlNumber
  • serviceReviewTrackingNumber
  • diagnosisCode
  • procedureCode
  • attachmentType
  • document content

API metadata (not sent to X12)

  • x-optum-consumer-correlation-id
  • requestId
  • environment
  • timestamp
  • gateway identifiers
API FieldX211 LocationX210 EquivalentComments
priorAuthorizationNumberTRN02 or REF02 (implementation specific)N/AVerify against API payload and generated X12
attachmentControlNumber2000A/TRN022000A/TRN02Common to both
claimNumberN/AREF segment in X210 workflowsUsually absent from X211
serviceReviewTrackingNumber2000A/TRN02N/AX211-specific
278 Request IdentifierTRN02 or REF02N/AUsed to correlate the 275 attachment to the originating 278 request

API transport and correlation fields

API FieldPurpose275X211 MappingX12 Transmitted
trackingNumberDepends on implementationTRN02 (if used as attachment control number)Conditional
attachmentControlNumberAttachment identifier2000A/TRN02Yes
serviceReviewTrackingNumberPrior auth correlation2000A/TRN02Yes
priorAuthorizationNumberVerify actual X12 outputTRN02 or REF02 (payer-specific)Yes
x-optum-consumer-correlation-idAPI gateway tracing onlyN/ANo
environmentAPI routing metadataN/ANo

📘

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 classification

Field CategoryExamplesSent to 275X211
Business DataMember ID, Diagnosis Code, Procedure Code, Prior Authorization NumberYes
Attachment DataLOINC, Attachment Type, PDF ContentYes
Attachment CorrelationAttachment Tracking NumberYes
API MetadataCorrelation ID, EnvironmentNo
Gateway MetadataRequest ID, Trace ID, TimestampNo

Clinical information

API FieldJSON PathLoopSegmentElementBusiness Meaning
Diagnosis CodediagnosisCode2000AREF*ICDREF02
Procedure CodeprocedureCode2000AREF*CPTREF02
Service Trace NumberserviceTraceNumber2000AREF*FJREF02
LOINC CodeloincCode2000ASTC01-02Requested Documentation Type
{
  "diagnosisCode": "K08.89",
  "*rocedureCode": "D4341",
  "loincCo*e": "27685-7"
}

Maps to

*TC*R4:27685-7::LOI~
REF**CD*K08.89~
REF*CPT*D4341~

Attachment metadata

API FieldJSON PathLoopSegmentElement
Submission DatesubmissionDate2100ADTP03Date Additional Info Submitted
Attachment TypeattachmentType2100ACAT02Image/PDF/CDA Indicator
File Format CodefileFormatCode2110AEFI01File Type
MIME TypemimeType2110AEFIDocumentation only

Attachment content

API FieldJSON PathLoopSegmentElement
Document Byte Countdocument.byteCount2110ABIN01Binary Length
Base64 Attachmentdocument.content2110ABIN02Actual Attachment Data
PDF Documentdocument.content2110ABIN02PDF Payload
TIFF Imagedocument.content2110ABIN02TIFF Payload
JPEG Imagedocument.content2110ABIN02JPEG Payload

Fields Not Translated into X12

API FieldX12 MappingReason
x-optum-consumer-correlation-idNoneAPI transaction tracing
requestIdNoneAPI response correlation
environmentNoneGateway routing
receivedTimestampNoneSystem metadata
nextPageTokenNonePagination 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.

275x211 Prior Authorization data dictionary

Loop 1000A — Information Source

API FieldLoop IDSegmentElement IDQualifierElement NameReqX12 Usage/TypeDescriptionExample
informationSource.name1000ANM1NM1031PName Last or Organization NameYRequired/StringSubmitting provider nameABC Dental
informationSource.npi1000ANM1NM109XXIdentification CodeYRequired/StringProvider NPI1234567890
informationSource.contactName1000APERPER02ICContact NameNSituational/StringProvider contactJohn Smith
informationSource.contactPhone1000APERPER04TECommunication NumberNSituational/StringContact phone8005551212
NM1*1P*2*ABC DENTAL*****XX*1234567890~
PER*IC*JOHN SMITH*TE*8005551212~

Loop 1000B — Information Receiver

API FieldLoop IDSegmentElement IDElement NameReqX12 Usage/TypeDescriptionExample
payer.name1000BNM1NM103Organization NameYRequired/StringReceiving payerUnitedHealthcare
payer.id1000BNM1NM109Identification CodeYRequired/StringPayer identifier87726
NM1*PR*2*UNITEDHEALTHCARE*****PI*87726~

Loop 1000C — Patient

API FieldLoop IDSegmentElement IDElement NameReqX12 Usage/TypeDescriptionExample
patient.memberId1000CNM1NM109Identification CodeYRequired/StringMember ID987654321
patient.lastName1000CNM1NM103Patient Last NameYRequired/StringPatient surnameDoe
patient.firstName1000CNM1NM104Patient First NameYRequired/StringPatient given nameJane
patient.accountNumber1000CREFREF02Reference IdentificationNSituational/StringPatient account number12345
patient.eventTrackingNumber1000CREFREF02Reference IdentificationNSituational/StringEvent tracking numberEVT12345
NM1*QC*1*DOE*JANE****MI*987654321~
REF*EJ*12345~
REF*2I*EVT12345~

Loop 2000A — Attachment Detail

API FieldLoop IDSegmentElementQualifierX12 Element NameX12 UsageRequiredSample ValueDescription
attachmentControlNumber2000ATRNTRN02N/AReference IdentificationRequiredYATT123456Attachment tracking identifier
priorAuthorizationNumber2000ATRN/REFTRN02 / REF02Implementation SpecificReference IdentificationSituationalYPA987654Prior authorization identifier
serviceReviewTrackingNumber2000ATRNTRN02N/AReference IdentificationSituationalNSR123456Service review tracking identifier
loincCode2000ASTCSTC01-02LOIIndustry CodeRequiredY27685-7Requested attachment type
diagnosisCode2000AREFREF02ICDReference IdentificationSituationalNK08.89Diagnosis code
procedureCode2000AREFREF02CPTReference IdentificationSituationalND4341Procedure code
serviceTraceNumber2000AREFREF02FJReference IdentificationSituationalNABC123Service trace number
LX*1~
TRN*2*ATT123456~
STC*R4:27685-7::LOI~
REF*ICD*K08.89~
REF*CPT*D4341~
REF*FJ*ABC123~

Loop 2100A — Additional Information

API FieldLoop IDSegmentElement IDElement NameReqX12 Usage/TypeDescriptionExample
submissionDate2100ADTPDTP03Date Time PeriodYRequired/DateDate submitted20260825
attachmentType2100ACATCAT02Category CodeYRequired/StringAttachment formatIA

Attachment type values

CAT02Description
IAImage Attachment
HLHL7 CDA
MBMIME Binary
TXText
DTP*368*D8*20260825~
CAT*AE*IA~

Loop 2110A — Attachment Content

API FieldLoop IDSegmentElement IDElement NameReqX12 Usage/TypeDescriptionExample
fileFormatCode2110AEFIEFI01External File Information CodeYRequired/StringFile format indicator05
document.byteCount2110ABINBIN01Binary Data LengthYRequired/IntegerAttachment size5000
document.content2110ABINBIN02Binary DataYRequired/Base64Encoded attachmentJVBERi0xLjQK
EFI*05~
BIN*5000*JVBERi0xLjQK...~

275X210 vs 275X211 mapping differences

Area275X210275X211
Business PurposeAdditional Information to Support a ClaimAdditional Information to Support a Health Care Services Review (Prior Auth)
Related Transaction837 Claim278 Prior Authorization
Attachment TrackingClaim-centricAuthorization-centric
LOINC UsageAttachment for claim adjudicationAttachment for utilization review/prior auth
Patient ContextClaim submissionService review request
Reference NumbersClaim identifiersPrior authorization/request identifiers
Common Workflow837 → 275X210278 → 275X211

Did this page help you?