This page is part of the FHIR Specification (v1.1.0: STU 3 Ballot 1). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions
. Page versions: R5 R4B R4 R3 R2
This is a frozen snapshot of the FHIR specification created for the purpose of balloting the GAO implementation Guide. It includes draft changes that may be part of the future DSTU 2.1 release but further change is expected. Readers should focus solely on the GAO implementation content, and FHIR DSTU 2 for other purposes.

Financial Management Work Group | Maturity Level: 0 | Compartments: Not linked to any defined compartments |
This resource provides the adjudication details from the processing of a Claim resource.

The ClaimResponse resource provides application level error or application level adjudication results which are the result of processing a submitted disciplineClaim which is the functional corollary of a Claim, Pre-Determination or a Pre-Authorization.
This is the adjudicated response to a Claim, Pre-determination or Pre-Authorization. The strength of the payment aspect of the response is matching to the strength of the original request. For a Claim the adjudication indicates payment which is intended to be made, for Pre-Authorization and Pre-Determination no payment will actually be made however funds may be reserved to settle a claim submitted later. Only an actual claim may be expected to result in actual payment.
The ClaimResponse resource is the response for the submission of: OralHealthClaim, VisionClaim etc. and Reversals.
Todo
This resource is referenced by claim

Structure
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() | Σ | DomainResource | Remittance resource | |
![]() ![]() | Σ | 0..* | Identifier | Response number |
![]() ![]() | Σ | 0..1 | Reference(Claim) | Id of resource triggering adjudication |
![]() ![]() | Σ | 0..1 | Coding | Resource version Ruleset Codes (Example) |
![]() ![]() | Σ | 0..1 | Coding | Original version Ruleset Codes (Example) |
![]() ![]() | Σ | 0..1 | dateTime | Creation date |
![]() ![]() | Σ | 0..1 | Reference(Organization) | Insurer |
![]() ![]() | Σ | 0..1 | Reference(Practitioner) | Responsible practitioner |
![]() ![]() | Σ | 0..1 | Reference(Organization) | Responsible organization |
![]() ![]() | Σ | 0..1 | code | complete | error RemittanceOutcome (Required) |
![]() ![]() | Σ | 0..1 | string | Disposition Message |
![]() ![]() | Σ | 0..1 | Coding | Party to be paid any benefits payable Payee Type Codes (Example) |
![]() ![]() | Σ | 0..* | BackboneElement | Line items |
![]() ![]() ![]() | Σ | 1..1 | positiveInt | Service instance |
![]() ![]() ![]() | Σ | 0..* | positiveInt | List of note numbers which apply |
![]() ![]() ![]() | Σ | 0..* | BackboneElement | Adjudication details |
![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Adjudication category such as co-pay, eligible, benefit, etc. Adjudication Codes (Extensible) |
![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Monetary amount |
![]() ![]() ![]() ![]() | Σ | 0..1 | decimal | Non-monetary value |
![]() ![]() ![]() | Σ | 0..* | BackboneElement | Detail line items |
![]() ![]() ![]() ![]() | Σ | 1..1 | positiveInt | Service instance |
![]() ![]() ![]() ![]() | Σ | 0..* | BackboneElement | Detail adjudication |
![]() ![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Adjudication category such as co-pay, eligible, benefit, etc. Adjudication Codes (Extensible) |
![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Monetary amount |
![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | decimal | Non-monetary value |
![]() ![]() ![]() ![]() | Σ | 0..* | BackboneElement | Subdetail line items |
![]() ![]() ![]() ![]() ![]() | Σ | 1..1 | positiveInt | Service instance |
![]() ![]() ![]() ![]() ![]() | Σ | 0..* | BackboneElement | Subdetail adjudication |
![]() ![]() ![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Adjudication category such as co-pay, eligible, benefit, etc. Adjudication Codes (Extensible) |
![]() ![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Monetary amount |
![]() ![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | decimal | Non-monetary value |
![]() ![]() | Σ | 0..* | BackboneElement | Insurer added line items |
![]() ![]() ![]() | Σ | 0..* | positiveInt | Service instances |
![]() ![]() ![]() | Σ | 1..1 | Coding | Group, Service or Product USCLS Codes (Example) |
![]() ![]() ![]() | Σ | 0..1 | Money | Professional fee or Product charge |
![]() ![]() ![]() | Σ | 0..* | positiveInt | List of note numbers which apply |
![]() ![]() ![]() | Σ | 0..* | BackboneElement | Added items adjudication |
![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Adjudication category such as co-pay, eligible, benefit, etc. Adjudication Codes (Extensible) |
![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Monetary amount |
![]() ![]() ![]() ![]() | Σ | 0..1 | decimal | Non-monetary value |
![]() ![]() ![]() | Σ | 0..* | BackboneElement | Added items details |
![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Service or Product USCLS Codes (Example) |
![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Professional fee or Product charge |
![]() ![]() ![]() ![]() | Σ | 0..* | BackboneElement | Added items detail adjudication |
![]() ![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Adjudication category such as co-pay, eligible, benefit, etc. Adjudication Codes (Extensible) |
![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Monetary amount |
![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | decimal | Non-monetary value |
![]() ![]() | Σ | 0..* | BackboneElement | Processing errors |
![]() ![]() ![]() | Σ | 0..1 | positiveInt | Item sequence number |
![]() ![]() ![]() | Σ | 0..1 | positiveInt | Detail sequence number |
![]() ![]() ![]() | Σ | 0..1 | positiveInt | Subdetail sequence number |
![]() ![]() ![]() | Σ | 1..1 | Coding | Error code detailing processing issues Adjudication Error Codes (Required) |
![]() ![]() | Σ | 0..1 | Money | Total Cost of service from the Claim |
![]() ![]() | Σ | 0..1 | Money | Unallocated deductible |
![]() ![]() | Σ | 0..1 | Money | Total benefit payable for the Claim |
![]() ![]() | Σ | 0..1 | Money | Payment adjustment for non-Claim issues |
![]() ![]() | Σ | 0..1 | Coding | Reason for Payment adjustment Adjustment Reason Codes (Extensible) |
![]() ![]() | Σ | 0..1 | date | Expected data of Payment |
![]() ![]() | Σ | 0..1 | Money | Payment amount |
![]() ![]() | Σ | 0..1 | Identifier | Payment identifier |
![]() ![]() | Σ | 0..1 | Coding | Funds reserved status Funds Reservation Codes (Example) |
![]() ![]() | Σ | 0..1 | Coding | Printed Form Identifier Form Codes (Required) |
![]() ![]() | Σ | 0..* | BackboneElement | Processing notes |
![]() ![]() ![]() | Σ | 0..1 | positiveInt | Note Number for this note |
![]() ![]() ![]() | Σ | 0..1 | Coding | display | print | printoper NoteType (Required) |
![]() ![]() ![]() | Σ | 0..1 | string | Note explanatory text |
![]() ![]() | Σ | 0..* | BackboneElement | Insurance or medical plan |
![]() ![]() ![]() | Σ | 1..1 | positiveInt | Service instance identifier |
![]() ![]() ![]() | Σ | 1..1 | boolean | Is the focal Coverage |
![]() ![]() ![]() | Σ | 1..1 | Reference(Coverage) | Insurance information |
![]() ![]() ![]() | Σ | 0..1 | string | Business agreement |
![]() ![]() ![]() | Σ | 1..1 | Coding | Patient relationship to subscriber Surface Codes (Example) |
![]() ![]() ![]() | Σ | 0..* | string | Pre-Authorization/Determination Reference |
![]() ![]() ![]() | Σ | 0..1 | Reference(ClaimResponse) | Adjudication results |
![]() ![]() ![]() | Σ | 0..1 | Coding | Original version Ruleset Codes (Example) |
Documentation for this format | ||||
UML Diagram
XML Template
<ClaimResponse xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Response number --></identifier> <request><!-- 0..1 Reference(Claim) Id of resource triggering adjudication --></request> <ruleset><!-- 0..1 Coding Resource version --></ruleset> <originalRuleset><!-- 0..1 Coding Original version --></originalRuleset> <created value="[dateTime]"/><!-- 0..1 Creation date --> <organization><!-- 0..1 Reference(Organization) Insurer --></organization> <requestProvider><!-- 0..1 Reference(Practitioner) Responsible practitioner --></requestProvider> <requestOrganization><!-- 0..1 Reference(Organization) Responsible organization --></requestOrganization> <outcome value="[code]"/><!-- 0..1 complete | error --> <disposition value="[string]"/><!-- 0..1 Disposition Message --> <payeeType><!-- 0..1 Coding Party to be paid any benefits payable --></payeeType> <item> <!-- 0..* Line items --> <sequenceLinkId value="[positiveInt]"/><!-- 1..1 Service instance --> <noteNumber value="[positiveInt]"/><!-- 0..* List of note numbers which apply --> <adjudication> <!-- 0..* Adjudication details --> <code><!-- 1..1 Coding Adjudication category such as co-pay, eligible, benefit, etc. --></code> <amount><!-- 0..1 Quantity(Money) Monetary amount --></amount> <value value="[decimal]"/><!-- 0..1 Non-monetary value --> </adjudication> <detail> <!-- 0..* Detail line items --> <sequenceLinkId value="[positiveInt]"/><!-- 1..1 Service instance --> <adjudication> <!-- 0..* Detail adjudication --> <code><!-- 1..1 Coding Adjudication category such as co-pay, eligible, benefit, etc. --></code> <amount><!-- 0..1 Quantity(Money) Monetary amount --></amount> <value value="[decimal]"/><!-- 0..1 Non-monetary value --> </adjudication> <subDetail> <!-- 0..* Subdetail line items --> <sequenceLinkId value="[positiveInt]"/><!-- 1..1 Service instance --> <adjudication> <!-- 0..* Subdetail adjudication --> <code><!-- 1..1 Coding Adjudication category such as co-pay, eligible, benefit, etc. --></code> <amount><!-- 0..1 Quantity(Money) Monetary amount --></amount> <value value="[decimal]"/><!-- 0..1 Non-monetary value --> </adjudication> </subDetail> </detail> </item> <addItem> <!-- 0..* Insurer added line items --> <sequenceLinkId value="[positiveInt]"/><!-- 0..* Service instances --> <service><!-- 1..1 Coding Group, Service or Product --></service> <fee><!-- 0..1 Quantity(Money) Professional fee or Product charge --></fee> <noteNumberLinkId value="[positiveInt]"/><!-- 0..* List of note numbers which apply --> <adjudication> <!-- 0..* Added items adjudication --> <code><!-- 1..1 Coding Adjudication category such as co-pay, eligible, benefit, etc. --></code> <amount><!-- 0..1 Quantity(Money) Monetary amount --></amount> <value value="[decimal]"/><!-- 0..1 Non-monetary value --> </adjudication> <detail> <!-- 0..* Added items details --> <service><!-- 1..1 Coding Service or Product --></service> <fee><!-- 0..1 Quantity(Money) Professional fee or Product charge --></fee> <adjudication> <!-- 0..* Added items detail adjudication --> <code><!-- 1..1 Coding Adjudication category such as co-pay, eligible, benefit, etc. --></code> <amount><!-- 0..1 Quantity(Money) Monetary amount --></amount> <value value="[decimal]"/><!-- 0..1 Non-monetary value --> </adjudication> </detail> </addItem> <error> <!-- 0..* Processing errors --> <sequenceLinkId value="[positiveInt]"/><!-- 0..1 Item sequence number --> <detailSequenceLinkId value="[positiveInt]"/><!-- 0..1 Detail sequence number --> <subdetailSequenceLinkId value="[positiveInt]"/><!-- 0..1 Subdetail sequence number --> <code><!-- 1..1 Coding Error code detailing processing issues --></code> </error> <totalCost><!-- 0..1 Quantity(Money) Total Cost of service from the Claim --></totalCost> <unallocDeductable><!-- 0..1 Quantity(Money) Unallocated deductible --></unallocDeductable> <totalBenefit><!-- 0..1 Quantity(Money) Total benefit payable for the Claim --></totalBenefit> <paymentAdjustment><!-- 0..1 Quantity(Money) Payment adjustment for non-Claim issues --></paymentAdjustment> <paymentAdjustmentReason><!-- 0..1 Coding Reason for Payment adjustment --></paymentAdjustmentReason> <paymentDate value="[date]"/><!-- 0..1 Expected data of Payment --> <paymentAmount><!-- 0..1 Quantity(Money) Payment amount --></paymentAmount> <paymentRef><!-- 0..1 Identifier Payment identifier --></paymentRef> <reserved><!-- 0..1 Coding Funds reserved status --></reserved> <form><!-- 0..1 Coding Printed Form Identifier --></form> <note> <!-- 0..* Processing notes --> <number value="[positiveInt]"/><!-- 0..1 Note Number for this note --> <type><!-- 0..1 Coding display | print | printoper --></type> <text value="[string]"/><!-- 0..1 Note explanatory text --> </note> <coverage> <!-- 0..* Insurance or medical plan --> <sequence value="[positiveInt]"/><!-- 1..1 Service instance identifier --> <focal value="[boolean]"/><!-- 1..1 Is the focal Coverage --> <coverage><!-- 1..1 Reference(Coverage) Insurance information --></coverage> <businessArrangement value="[string]"/><!-- 0..1 Business agreement --> <relationship><!-- 1..1 Coding Patient relationship to subscriber --></relationship> <preAuthRef value="[string]"/><!-- 0..* Pre-Authorization/Determination Reference --> <claimResponse><!-- 0..1 Reference(ClaimResponse) Adjudication results --></claimResponse> <originalRuleset><!-- 0..1 Coding Original version --></originalRuleset> </coverage> </ClaimResponse>
JSON Template
{
"resourceType" : "ClaimResponse",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Response number
"request" : { Reference(Claim) }, // Id of resource triggering adjudication
"ruleset" : { Coding }, // Resource version
"originalRuleset" : { Coding }, // Original version
"created" : "<dateTime>", // Creation date
"organization" : { Reference(Organization) }, // Insurer
"requestProvider" : { Reference(Practitioner) }, // Responsible practitioner
"requestOrganization" : { Reference(Organization) }, // Responsible organization
"outcome" : "<code>", // complete | error
"disposition" : "<string>", // Disposition Message
"payeeType" : { Coding }, // Party to be paid any benefits payable
"item" : [{ // Line items
"sequenceLinkId" : "<positiveInt>", // R! Service instance
"noteNumber" : ["<positiveInt>"], // List of note numbers which apply
"adjudication" : [{ // Adjudication details
"code" : { Coding }, // R! Adjudication category such as co-pay, eligible, benefit, etc.
"amount" : { Quantity(Money) }, // Monetary amount
"value" : <decimal> // Non-monetary value
}],
"detail" : [{ // Detail line items
"sequenceLinkId" : "<positiveInt>", // R! Service instance
"adjudication" : [{ // Detail adjudication
"code" : { Coding }, // R! Adjudication category such as co-pay, eligible, benefit, etc.
"amount" : { Quantity(Money) }, // Monetary amount
"value" : <decimal> // Non-monetary value
}],
"subDetail" : [{ // Subdetail line items
"sequenceLinkId" : "<positiveInt>", // R! Service instance
"adjudication" : [{ // Subdetail adjudication
"code" : { Coding }, // R! Adjudication category such as co-pay, eligible, benefit, etc.
"amount" : { Quantity(Money) }, // Monetary amount
"value" : <decimal> // Non-monetary value
}]
}]
}]
}],
"addItem" : [{ // Insurer added line items
"sequenceLinkId" : ["<positiveInt>"], // Service instances
"service" : { Coding }, // R! Group, Service or Product
"fee" : { Quantity(Money) }, // Professional fee or Product charge
"noteNumberLinkId" : ["<positiveInt>"], // List of note numbers which apply
"adjudication" : [{ // Added items adjudication
"code" : { Coding }, // R! Adjudication category such as co-pay, eligible, benefit, etc.
"amount" : { Quantity(Money) }, // Monetary amount
"value" : <decimal> // Non-monetary value
}],
"detail" : [{ // Added items details
"service" : { Coding }, // R! Service or Product
"fee" : { Quantity(Money) }, // Professional fee or Product charge
"adjudication" : [{ // Added items detail adjudication
"code" : { Coding }, // R! Adjudication category such as co-pay, eligible, benefit, etc.
"amount" : { Quantity(Money) }, // Monetary amount
"value" : <decimal> // Non-monetary value
}]
}]
}],
"error" : [{ // Processing errors
"sequenceLinkId" : "<positiveInt>", // Item sequence number
"detailSequenceLinkId" : "<positiveInt>", // Detail sequence number
"subdetailSequenceLinkId" : "<positiveInt>", // Subdetail sequence number
"code" : { Coding } // R! Error code detailing processing issues
}],
"totalCost" : { Quantity(Money) }, // Total Cost of service from the Claim
"unallocDeductable" : { Quantity(Money) }, // Unallocated deductible
"totalBenefit" : { Quantity(Money) }, // Total benefit payable for the Claim
"paymentAdjustment" : { Quantity(Money) }, // Payment adjustment for non-Claim issues
"paymentAdjustmentReason" : { Coding }, // Reason for Payment adjustment
"paymentDate" : "<date>", // Expected data of Payment
"paymentAmount" : { Quantity(Money) }, // Payment amount
"paymentRef" : { Identifier }, // Payment identifier
"reserved" : { Coding }, // Funds reserved status
"form" : { Coding }, // Printed Form Identifier
"note" : [{ // Processing notes
"number" : "<positiveInt>", // Note Number for this note
"type" : { Coding }, // display | print | printoper
"text" : "<string>" // Note explanatory text
}],
"coverage" : [{ // Insurance or medical plan
"sequence" : "<positiveInt>", // R! Service instance identifier
"focal" : <boolean>, // R! Is the focal Coverage
"coverage" : { Reference(Coverage) }, // R! Insurance information
"businessArrangement" : "<string>", // Business agreement
"relationship" : { Coding }, // R! Patient relationship to subscriber
"preAuthRef" : ["<string>"], // Pre-Authorization/Determination Reference
"claimResponse" : { Reference(ClaimResponse) }, // Adjudication results
"originalRuleset" : { Coding } // Original version
}]
}
Structure
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() | Σ | DomainResource | Remittance resource | |
![]() ![]() | Σ | 0..* | Identifier | Response number |
![]() ![]() | Σ | 0..1 | Reference(Claim) | Id of resource triggering adjudication |
![]() ![]() | Σ | 0..1 | Coding | Resource version Ruleset Codes (Example) |
![]() ![]() | Σ | 0..1 | Coding | Original version Ruleset Codes (Example) |
![]() ![]() | Σ | 0..1 | dateTime | Creation date |
![]() ![]() | Σ | 0..1 | Reference(Organization) | Insurer |
![]() ![]() | Σ | 0..1 | Reference(Practitioner) | Responsible practitioner |
![]() ![]() | Σ | 0..1 | Reference(Organization) | Responsible organization |
![]() ![]() | Σ | 0..1 | code | complete | error RemittanceOutcome (Required) |
![]() ![]() | Σ | 0..1 | string | Disposition Message |
![]() ![]() | Σ | 0..1 | Coding | Party to be paid any benefits payable Payee Type Codes (Example) |
![]() ![]() | Σ | 0..* | BackboneElement | Line items |
![]() ![]() ![]() | Σ | 1..1 | positiveInt | Service instance |
![]() ![]() ![]() | Σ | 0..* | positiveInt | List of note numbers which apply |
![]() ![]() ![]() | Σ | 0..* | BackboneElement | Adjudication details |
![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Adjudication category such as co-pay, eligible, benefit, etc. Adjudication Codes (Extensible) |
![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Monetary amount |
![]() ![]() ![]() ![]() | Σ | 0..1 | decimal | Non-monetary value |
![]() ![]() ![]() | Σ | 0..* | BackboneElement | Detail line items |
![]() ![]() ![]() ![]() | Σ | 1..1 | positiveInt | Service instance |
![]() ![]() ![]() ![]() | Σ | 0..* | BackboneElement | Detail adjudication |
![]() ![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Adjudication category such as co-pay, eligible, benefit, etc. Adjudication Codes (Extensible) |
![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Monetary amount |
![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | decimal | Non-monetary value |
![]() ![]() ![]() ![]() | Σ | 0..* | BackboneElement | Subdetail line items |
![]() ![]() ![]() ![]() ![]() | Σ | 1..1 | positiveInt | Service instance |
![]() ![]() ![]() ![]() ![]() | Σ | 0..* | BackboneElement | Subdetail adjudication |
![]() ![]() ![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Adjudication category such as co-pay, eligible, benefit, etc. Adjudication Codes (Extensible) |
![]() ![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Monetary amount |
![]() ![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | decimal | Non-monetary value |
![]() ![]() | Σ | 0..* | BackboneElement | Insurer added line items |
![]() ![]() ![]() | Σ | 0..* | positiveInt | Service instances |
![]() ![]() ![]() | Σ | 1..1 | Coding | Group, Service or Product USCLS Codes (Example) |
![]() ![]() ![]() | Σ | 0..1 | Money | Professional fee or Product charge |
![]() ![]() ![]() | Σ | 0..* | positiveInt | List of note numbers which apply |
![]() ![]() ![]() | Σ | 0..* | BackboneElement | Added items adjudication |
![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Adjudication category such as co-pay, eligible, benefit, etc. Adjudication Codes (Extensible) |
![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Monetary amount |
![]() ![]() ![]() ![]() | Σ | 0..1 | decimal | Non-monetary value |
![]() ![]() ![]() | Σ | 0..* | BackboneElement | Added items details |
![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Service or Product USCLS Codes (Example) |
![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Professional fee or Product charge |
![]() ![]() ![]() ![]() | Σ | 0..* | BackboneElement | Added items detail adjudication |
![]() ![]() ![]() ![]() ![]() | Σ | 1..1 | Coding | Adjudication category such as co-pay, eligible, benefit, etc. Adjudication Codes (Extensible) |
![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | Money | Monetary amount |
![]() ![]() ![]() ![]() ![]() | Σ | 0..1 | decimal | Non-monetary value |
![]() ![]() | Σ | 0..* | BackboneElement | Processing errors |
![]() ![]() ![]() | Σ | 0..1 | positiveInt | Item sequence number |
![]() ![]() ![]() | Σ | 0..1 | positiveInt | Detail sequence number |
![]() ![]() ![]() | Σ | 0..1 | positiveInt | Subdetail sequence number |
![]() ![]() ![]() | Σ | 1..1 | Coding | Error code detailing processing issues Adjudication Error Codes (Required) |
![]() ![]() | Σ | 0..1 | Money | Total Cost of service from the Claim |
![]() ![]() | Σ | 0..1 | Money | Unallocated deductible |
![]() ![]() | Σ | 0..1 | Money | Total benefit payable for the Claim |
![]() ![]() | Σ | 0..1 | Money | Payment adjustment for non-Claim issues |
![]() ![]() | Σ | 0..1 | Coding | Reason for Payment adjustment Adjustment Reason Codes (Extensible) |
![]() ![]() | Σ | 0..1 | date | Expected data of Payment |
![]() ![]() | Σ | 0..1 | Money | Payment amount |
![]() ![]() | Σ | 0..1 | Identifier | Payment identifier |
![]() ![]() | Σ | 0..1 | Coding | Funds reserved status Funds Reservation Codes (Example) |
![]() ![]() | Σ | 0..1 | Coding | Printed Form Identifier Form Codes (Required) |
![]() ![]() | Σ | 0..* | BackboneElement | Processing notes |
![]() ![]() ![]() | Σ | 0..1 | positiveInt | Note Number for this note |
![]() ![]() ![]() | Σ | 0..1 | Coding | display | print | printoper NoteType (Required) |
![]() ![]() ![]() | Σ | 0..1 | string | Note explanatory text |
![]() ![]() | Σ | 0..* | BackboneElement | Insurance or medical plan |
![]() ![]() ![]() | Σ | 1..1 | positiveInt | Service instance identifier |
![]() ![]() ![]() | Σ | 1..1 | boolean | Is the focal Coverage |
![]() ![]() ![]() | Σ | 1..1 | Reference(Coverage) | Insurance information |
![]() ![]() ![]() | Σ | 0..1 | string | Business agreement |
![]() ![]() ![]() | Σ | 1..1 | Coding | Patient relationship to subscriber Surface Codes (Example) |
![]() ![]() ![]() | Σ | 0..* | string | Pre-Authorization/Determination Reference |
![]() ![]() ![]() | Σ | 0..1 | Reference(ClaimResponse) | Adjudication results |
![]() ![]() ![]() | Σ | 0..1 | Coding | Original version Ruleset Codes (Example) |
Documentation for this format | ||||
XML Template
<ClaimResponse xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Response number --></identifier> <request><!-- 0..1 Reference(Claim) Id of resource triggering adjudication --></request> <ruleset><!-- 0..1 Coding Resource version --></ruleset> <originalRuleset><!-- 0..1 Coding Original version --></originalRuleset> <created value="[dateTime]"/><!-- 0..1 Creation date --> <organization><!-- 0..1 Reference(Organization) Insurer --></organization> <requestProvider><!-- 0..1 Reference(Practitioner) Responsible practitioner --></requestProvider> <requestOrganization><!-- 0..1 Reference(Organization) Responsible organization --></requestOrganization> <outcome value="[code]"/><!-- 0..1 complete | error --> <disposition value="[string]"/><!-- 0..1 Disposition Message --> <payeeType><!-- 0..1 Coding Party to be paid any benefits payable --></payeeType> <item> <!-- 0..* Line items --> <sequenceLinkId value="[positiveInt]"/><!-- 1..1 Service instance --> <noteNumber value="[positiveInt]"/><!-- 0..* List of note numbers which apply --> <adjudication> <!-- 0..* Adjudication details --> <code><!-- 1..1 Coding Adjudication category such as co-pay, eligible, benefit, etc. --></code> <amount><!-- 0..1 Quantity(Money) Monetary amount --></amount> <value value="[decimal]"/><!-- 0..1 Non-monetary value --> </adjudication> <detail> <!-- 0..* Detail line items --> <sequenceLinkId value="[positiveInt]"/><!-- 1..1 Service instance --> <adjudication> <!-- 0..* Detail adjudication --> <code><!-- 1..1 Coding Adjudication category such as co-pay, eligible, benefit, etc. --></code> <amount><!-- 0..1 Quantity(Money) Monetary amount --></amount> <value value="[decimal]"/><!-- 0..1 Non-monetary value --> </adjudication> <subDetail> <!-- 0..* Subdetail line items --> <sequenceLinkId value="[positiveInt]"/><!-- 1..1 Service instance --> <adjudication> <!-- 0..* Subdetail adjudication --> <code><!-- 1..1 Coding Adjudication category such as co-pay, eligible, benefit, etc. --></code> <amount><!-- 0..1 Quantity(Money) Monetary amount --></amount> <value value="[decimal]"/><!-- 0..1 Non-monetary value --> </adjudication> </subDetail> </detail> </item> <addItem> <!-- 0..* Insurer added line items --> <sequenceLinkId value="[positiveInt]"/><!-- 0..* Service instances --> <service><!-- 1..1 Coding Group, Service or Product --></service> <fee><!-- 0..1 Quantity(Money) Professional fee or Product charge --></fee> <noteNumberLinkId value="[positiveInt]"/><!-- 0..* List of note numbers which apply --> <adjudication> <!-- 0..* Added items adjudication --> <code><!-- 1..1 Coding Adjudication category such as co-pay, eligible, benefit, etc. --></code> <amount><!-- 0..1 Quantity(Money) Monetary amount --></amount> <value value="[decimal]"/><!-- 0..1 Non-monetary value --> </adjudication> <detail> <!-- 0..* Added items details --> <service><!-- 1..1 Coding Service or Product --></service> <fee><!-- 0..1 Quantity(Money) Professional fee or Product charge --></fee> <adjudication> <!-- 0..* Added items detail adjudication --> <code><!-- 1..1 Coding Adjudication category such as co-pay, eligible, benefit, etc. --></code> <amount><!-- 0..1 Quantity(Money) Monetary amount --></amount> <value value="[decimal]"/><!-- 0..1 Non-monetary value --> </adjudication> </detail> </addItem> <error> <!-- 0..* Processing errors --> <sequenceLinkId value="[positiveInt]"/><!-- 0..1 Item sequence number --> <detailSequenceLinkId value="[positiveInt]"/><!-- 0..1 Detail sequence number --> <subdetailSequenceLinkId value="[positiveInt]"/><!-- 0..1 Subdetail sequence number --> <code><!-- 1..1 Coding Error code detailing processing issues --></code> </error> <totalCost><!-- 0..1 Quantity(Money) Total Cost of service from the Claim --></totalCost> <unallocDeductable><!-- 0..1 Quantity(Money) Unallocated deductible --></unallocDeductable> <totalBenefit><!-- 0..1 Quantity(Money) Total benefit payable for the Claim --></totalBenefit> <paymentAdjustment><!-- 0..1 Quantity(Money) Payment adjustment for non-Claim issues --></paymentAdjustment> <paymentAdjustmentReason><!-- 0..1 Coding Reason for Payment adjustment --></paymentAdjustmentReason> <paymentDate value="[date]"/><!-- 0..1 Expected data of Payment --> <paymentAmount><!-- 0..1 Quantity(Money) Payment amount --></paymentAmount> <paymentRef><!-- 0..1 Identifier Payment identifier --></paymentRef> <reserved><!-- 0..1 Coding Funds reserved status --></reserved> <form><!-- 0..1 Coding Printed Form Identifier --></form> <note> <!-- 0..* Processing notes --> <number value="[positiveInt]"/><!-- 0..1 Note Number for this note --> <type><!-- 0..1 Coding display | print | printoper --></type> <text value="[string]"/><!-- 0..1 Note explanatory text --> </note> <coverage> <!-- 0..* Insurance or medical plan --> <sequence value="[positiveInt]"/><!-- 1..1 Service instance identifier --> <focal value="[boolean]"/><!-- 1..1 Is the focal Coverage --> <coverage><!-- 1..1 Reference(Coverage) Insurance information --></coverage> <businessArrangement value="[string]"/><!-- 0..1 Business agreement --> <relationship><!-- 1..1 Coding Patient relationship to subscriber --></relationship> <preAuthRef value="[string]"/><!-- 0..* Pre-Authorization/Determination Reference --> <claimResponse><!-- 0..1 Reference(ClaimResponse) Adjudication results --></claimResponse> <originalRuleset><!-- 0..1 Coding Original version --></originalRuleset> </coverage> </ClaimResponse>
JSON Template
{
"resourceType" : "ClaimResponse",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Response number
"request" : { Reference(Claim) }, // Id of resource triggering adjudication
"ruleset" : { Coding }, // Resource version
"originalRuleset" : { Coding }, // Original version
"created" : "<dateTime>", // Creation date
"organization" : { Reference(Organization) }, // Insurer
"requestProvider" : { Reference(Practitioner) }, // Responsible practitioner
"requestOrganization" : { Reference(Organization) }, // Responsible organization
"outcome" : "<code>", // complete | error
"disposition" : "<string>", // Disposition Message
"payeeType" : { Coding }, // Party to be paid any benefits payable
"item" : [{ // Line items
"sequenceLinkId" : "<positiveInt>", // R! Service instance
"noteNumber" : ["<positiveInt>"], // List of note numbers which apply
"adjudication" : [{ // Adjudication details
"code" : { Coding }, // R! Adjudication category such as co-pay, eligible, benefit, etc.
"amount" : { Quantity(Money) }, // Monetary amount
"value" : <decimal> // Non-monetary value
}],
"detail" : [{ // Detail line items
"sequenceLinkId" : "<positiveInt>", // R! Service instance
"adjudication" : [{ // Detail adjudication
"code" : { Coding }, // R! Adjudication category such as co-pay, eligible, benefit, etc.
"amount" : { Quantity(Money) }, // Monetary amount
"value" : <decimal> // Non-monetary value
}],
"subDetail" : [{ // Subdetail line items
"sequenceLinkId" : "<positiveInt>", // R! Service instance
"adjudication" : [{ // Subdetail adjudication
"code" : { Coding }, // R! Adjudication category such as co-pay, eligible, benefit, etc.
"amount" : { Quantity(Money) }, // Monetary amount
"value" : <decimal> // Non-monetary value
}]
}]
}]
}],
"addItem" : [{ // Insurer added line items
"sequenceLinkId" : ["<positiveInt>"], // Service instances
"service" : { Coding }, // R! Group, Service or Product
"fee" : { Quantity(Money) }, // Professional fee or Product charge
"noteNumberLinkId" : ["<positiveInt>"], // List of note numbers which apply
"adjudication" : [{ // Added items adjudication
"code" : { Coding }, // R! Adjudication category such as co-pay, eligible, benefit, etc.
"amount" : { Quantity(Money) }, // Monetary amount
"value" : <decimal> // Non-monetary value
}],
"detail" : [{ // Added items details
"service" : { Coding }, // R! Service or Product
"fee" : { Quantity(Money) }, // Professional fee or Product charge
"adjudication" : [{ // Added items detail adjudication
"code" : { Coding }, // R! Adjudication category such as co-pay, eligible, benefit, etc.
"amount" : { Quantity(Money) }, // Monetary amount
"value" : <decimal> // Non-monetary value
}]
}]
}],
"error" : [{ // Processing errors
"sequenceLinkId" : "<positiveInt>", // Item sequence number
"detailSequenceLinkId" : "<positiveInt>", // Detail sequence number
"subdetailSequenceLinkId" : "<positiveInt>", // Subdetail sequence number
"code" : { Coding } // R! Error code detailing processing issues
}],
"totalCost" : { Quantity(Money) }, // Total Cost of service from the Claim
"unallocDeductable" : { Quantity(Money) }, // Unallocated deductible
"totalBenefit" : { Quantity(Money) }, // Total benefit payable for the Claim
"paymentAdjustment" : { Quantity(Money) }, // Payment adjustment for non-Claim issues
"paymentAdjustmentReason" : { Coding }, // Reason for Payment adjustment
"paymentDate" : "<date>", // Expected data of Payment
"paymentAmount" : { Quantity(Money) }, // Payment amount
"paymentRef" : { Identifier }, // Payment identifier
"reserved" : { Coding }, // Funds reserved status
"form" : { Coding }, // Printed Form Identifier
"note" : [{ // Processing notes
"number" : "<positiveInt>", // Note Number for this note
"type" : { Coding }, // display | print | printoper
"text" : "<string>" // Note explanatory text
}],
"coverage" : [{ // Insurance or medical plan
"sequence" : "<positiveInt>", // R! Service instance identifier
"focal" : <boolean>, // R! Is the focal Coverage
"coverage" : { Reference(Coverage) }, // R! Insurance information
"businessArrangement" : "<string>", // Business agreement
"relationship" : { Coding }, // R! Patient relationship to subscriber
"preAuthRef" : ["<string>"], // Pre-Authorization/Determination Reference
"claimResponse" : { Reference(ClaimResponse) }, // Adjudication results
"originalRuleset" : { Coding } // Original version
}]
}
Alternate definitions: Schema/Schematron, Resource Profile (XML, JSON), Questionnaire

| Path | Definition | Type | Reference |
|---|---|---|---|
| ClaimResponse.ruleset ClaimResponse.originalRuleset ClaimResponse.coverage.originalRuleset | The static and dynamic model to which contents conform, which may be business version or standard/version. | Example | Ruleset Codes |
| ClaimResponse.outcome | The outcome of the processing. | Required | RemittanceOutcome |
| ClaimResponse.payeeType | A code for the party to be reimbursed. | Example | Payee Type Codes |
| ClaimResponse.item.adjudication.code ClaimResponse.item.detail.adjudication.code ClaimResponse.item.detail.subDetail.adjudication.code ClaimResponse.addItem.adjudication.code ClaimResponse.addItem.detail.adjudication.code | The adjudication codes. | Extensible | Adjudication Codes |
| ClaimResponse.addItem.service ClaimResponse.addItem.detail.service | Allowable service and product codes. | Example | USCLS Codes |
| ClaimResponse.error.code | The error codes for adjudication processing. | Required | Adjudication Error Codes |
| ClaimResponse.paymentAdjustmentReason | Adjustment reason codes. | Extensible | Adjustment Reason Codes |
| ClaimResponse.reserved | For whom funds are to be reserved: (Patient, Provider, None). | Example | Funds Reservation Codes |
| ClaimResponse.form | The forms codes. | Required | Form Codes |
| ClaimResponse.note.type | The presentation types of notes. | Required | NoteType |
| ClaimResponse.coverage.relationship | The code for the relationship of the patient to the subscriber. | Example | Surface Codes |

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
| Name | Type | Description | Paths |
| identifier | token | The identity of the insurer | ClaimResponse.identifier |