This page is part of the FHIR Specification (v1.2.0: STU 3 Draft). 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

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 and ExplanationOfBenefit

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 (Extensible) |
![]() ![]() | Σ | 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 Payment 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 (Extensible) |
![]() ![]() | Σ | 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 Payment 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 adjudication error codes. | Extensible | Adjudication Error Codes |
| ClaimResponse.paymentAdjustmentReason | Payment Adjustment reason codes. | Extensible | Payment 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 |
| created | date | The creation date | ClaimResponse.created |
| disposition | string | The contents of the disposition message | ClaimResponse.disposition |
| identifier | token | The identity of the insurer | ClaimResponse.identifier |
| organization | reference | The organization who generated this resource | ClaimResponse.organization (Organization) |
| outcome | token | The processing outcome | ClaimResponse.outcome |
| paymentdate | date | The expected paymentDate | ClaimResponse.paymentDate |
| request | reference | The claim reference | ClaimResponse.request (Claim) |