This page is part of the FHIR Specification (v1.8.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: R3 R2
Financial Management Work Group | Maturity Level: 1 | Compartments: Not linked to any defined compartments |
This resource provides eligibility and plan details from the processing of an Eligibility resource.
The EligibilityResponse resource provides eligibility and plan details from the processing of an EligibilityRequest resource. It combines key information from a payor as to whether a Coverage is in-force, and optionally the nature of the Policy details.
Structure
UML Diagram (Legend)
XML Template
<EligibilityResponse xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Business Identifier --></identifier> <status value="[code]"/><!-- 0..1 active | cancelled | draft | entered-in-error --> <created value="[dateTime]"/><!-- 0..1 Creation date --> <requestProvider><!-- 0..1 Reference(Practitioner) Responsible practitioner --></requestProvider> <requestOrganization><!-- 0..1 Reference(Organization) Responsible organization --></requestOrganization> <request><!-- 0..1 Reference(EligibilityRequest) Eligibility reference --></request> <outcome><!-- 0..1 CodeableConcept complete | error | partial --></outcome> <disposition value="[string]"/><!-- 0..1 Disposition Message --> <insurer><!-- 0..1 Reference(Organization) Insurer --></insurer> <inforce value="[boolean]"/><!-- 0..1 Coverage inforce --> <insurance> <!-- 0..* Details by insurance coverage --> <coverage><!-- 0..1 Reference(Coverage) Updated Coverage details --></coverage> <contract><!-- 0..1 Reference(Contract) Contract details --></contract> <benefitBalance> <!-- 0..* Benefits by Category --> <category><!-- 1..1 CodeableConcept Benefit Category --></category> <subCategory><!-- 0..1 CodeableConcept Benefit SubCategory --></subCategory> <excluded value="[boolean]"/><!-- 0..1 Excluded from the plan --> <name value="[string]"/><!-- 0..1 Short name for the benefit --> <description value="[string]"/><!-- 0..1 Description of the benefit --> <network><!-- 0..1 CodeableConcept In or out of network --></network> <unit><!-- 0..1 CodeableConcept Individual or family --></unit> <term><!-- 0..1 CodeableConcept Annual or lifetime --></term> <financial> <!-- 0..* Benefit Summary --> <type><!-- 1..1 CodeableConcept Deductable, visits, benefit amount --></type> <benefit[x]><!-- 0..1 unsignedInt|string|Money Benefits allowed --></benefit[x]> <benefitUsed[x]><!-- 0..1 unsignedInt|Money Benefits used --></benefitUsed[x]> </financial> </benefitBalance> </insurance> <form><!-- 0..1 CodeableConcept Printed Form Identifier --></form> <error> <!-- 0..* Processing errors --> <code><!-- 1..1 CodeableConcept Error code detailing processing issues --></code> </error> </EligibilityResponse>
JSON Template
{ "resourceType" : "EligibilityResponse", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // Business Identifier "status" : "<code>", // active | cancelled | draft | entered-in-error "created" : "<dateTime>", // Creation date "requestProvider" : { Reference(Practitioner) }, // Responsible practitioner "requestOrganization" : { Reference(Organization) }, // Responsible organization "request" : { Reference(EligibilityRequest) }, // Eligibility reference "outcome" : { CodeableConcept }, // complete | error | partial "disposition" : "<string>", // Disposition Message "insurer" : { Reference(Organization) }, // Insurer "inforce" : <boolean>, // Coverage inforce "insurance" : [{ // Details by insurance coverage "coverage" : { Reference(Coverage) }, // Updated Coverage details "contract" : { Reference(Contract) }, // Contract details "benefitBalance" : [{ // Benefits by Category "category" : { CodeableConcept }, // R! Benefit Category "subCategory" : { CodeableConcept }, // Benefit SubCategory "excluded" : <boolean>, // Excluded from the plan "name" : "<string>", // Short name for the benefit "description" : "<string>", // Description of the benefit "network" : { CodeableConcept }, // In or out of network "unit" : { CodeableConcept }, // Individual or family "term" : { CodeableConcept }, // Annual or lifetime "financial" : [{ // Benefit Summary "type" : { CodeableConcept }, // R! Deductable, visits, benefit amount // benefit[x]: Benefits allowed. One of these 3: "benefitUnsignedInt" : "<unsignedInt>", "benefitString" : "<string>", "benefitMoney" : { Money }, // benefitUsed[x]: Benefits used. One of these 2: "benefitUsedUnsignedInt" : "<unsignedInt>" "benefitUsedMoney" : { Money } }] }] }], "form" : { CodeableConcept }, // Printed Form Identifier "error" : [{ // Processing errors "code" : { CodeableConcept } // R! Error code detailing processing issues }] }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:EligibilityResponse; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:EligibilityResponse.identifier [ Identifier ], ... ; # 0..* Business Identifier fhir:EligibilityResponse.status [ code ]; # 0..1 active | cancelled | draft | entered-in-error fhir:EligibilityResponse.created [ dateTime ]; # 0..1 Creation date fhir:EligibilityResponse.requestProvider [ Reference(Practitioner) ]; # 0..1 Responsible practitioner fhir:EligibilityResponse.requestOrganization [ Reference(Organization) ]; # 0..1 Responsible organization fhir:EligibilityResponse.request [ Reference(EligibilityRequest) ]; # 0..1 Eligibility reference fhir:EligibilityResponse.outcome [ CodeableConcept ]; # 0..1 complete | error | partial fhir:EligibilityResponse.disposition [ string ]; # 0..1 Disposition Message fhir:EligibilityResponse.insurer [ Reference(Organization) ]; # 0..1 Insurer fhir:EligibilityResponse.inforce [ boolean ]; # 0..1 Coverage inforce fhir:EligibilityResponse.insurance [ # 0..* Details by insurance coverage fhir:EligibilityResponse.insurance.coverage [ Reference(Coverage) ]; # 0..1 Updated Coverage details fhir:EligibilityResponse.insurance.contract [ Reference(Contract) ]; # 0..1 Contract details fhir:EligibilityResponse.insurance.benefitBalance [ # 0..* Benefits by Category fhir:EligibilityResponse.insurance.benefitBalance.category [ CodeableConcept ]; # 1..1 Benefit Category fhir:EligibilityResponse.insurance.benefitBalance.subCategory [ CodeableConcept ]; # 0..1 Benefit SubCategory fhir:EligibilityResponse.insurance.benefitBalance.excluded [ boolean ]; # 0..1 Excluded from the plan fhir:EligibilityResponse.insurance.benefitBalance.name [ string ]; # 0..1 Short name for the benefit fhir:EligibilityResponse.insurance.benefitBalance.description [ string ]; # 0..1 Description of the benefit fhir:EligibilityResponse.insurance.benefitBalance.network [ CodeableConcept ]; # 0..1 In or out of network fhir:EligibilityResponse.insurance.benefitBalance.unit [ CodeableConcept ]; # 0..1 Individual or family fhir:EligibilityResponse.insurance.benefitBalance.term [ CodeableConcept ]; # 0..1 Annual or lifetime fhir:EligibilityResponse.insurance.benefitBalance.financial [ # 0..* Benefit Summary fhir:EligibilityResponse.insurance.benefitBalance.financial.type [ CodeableConcept ]; # 1..1 Deductable, visits, benefit amount # EligibilityResponse.insurance.benefitBalance.financial.benefit[x] : 0..1 Benefits allowed. One of these 3 fhir:EligibilityResponse.insurance.benefitBalance.financial.benefitUnsignedInt [ unsignedInt ] fhir:EligibilityResponse.insurance.benefitBalance.financial.benefitString [ string ] fhir:EligibilityResponse.insurance.benefitBalance.financial.benefitMoney [ Money ] # EligibilityResponse.insurance.benefitBalance.financial.benefitUsed[x] : 0..1 Benefits used. One of these 2 fhir:EligibilityResponse.insurance.benefitBalance.financial.benefitUsedUnsignedInt [ unsignedInt ] fhir:EligibilityResponse.insurance.benefitBalance.financial.benefitUsedMoney [ Money ] ], ...; ], ...; ], ...; fhir:EligibilityResponse.form [ CodeableConcept ]; # 0..1 Printed Form Identifier fhir:EligibilityResponse.error [ # 0..* Processing errors fhir:EligibilityResponse.error.code [ CodeableConcept ]; # 1..1 Error code detailing processing issues ], ...; ]
Changes since DSTU2
EligibilityResponse | |
EligibilityResponse.status | added Element |
EligibilityResponse.outcome | Type changed from code to CodeableConcept |
EligibilityResponse.insurer | added Element |
EligibilityResponse.inforce | added Element |
EligibilityResponse.insurance | added Element |
EligibilityResponse.insurance.coverage | added Element |
EligibilityResponse.insurance.contract | added Element |
EligibilityResponse.insurance.benefitBalance | added Element |
EligibilityResponse.insurance.benefitBalance.category | added Element |
EligibilityResponse.insurance.benefitBalance.subCategory | added Element |
EligibilityResponse.insurance.benefitBalance.excluded | added Element |
EligibilityResponse.insurance.benefitBalance.name | added Element |
EligibilityResponse.insurance.benefitBalance.description | added Element |
EligibilityResponse.insurance.benefitBalance.network | added Element |
EligibilityResponse.insurance.benefitBalance.unit | added Element |
EligibilityResponse.insurance.benefitBalance.term | added Element |
EligibilityResponse.insurance.benefitBalance.financial | added Element |
EligibilityResponse.insurance.benefitBalance.financial.type | added Element |
EligibilityResponse.insurance.benefitBalance.financial.benefit[x] | added Element |
EligibilityResponse.insurance.benefitBalance.financial.benefitUsed[x] | added Element |
EligibilityResponse.form | added Element |
EligibilityResponse.error | added Element |
EligibilityResponse.error.code | added Element |
EligibilityResponse.ruleset | deleted |
EligibilityResponse.originalRuleset | deleted |
EligibilityResponse.organization | deleted |
See the Full Difference for further information
Structure
XML Template
<EligibilityResponse xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Business Identifier --></identifier> <status value="[code]"/><!-- 0..1 active | cancelled | draft | entered-in-error --> <created value="[dateTime]"/><!-- 0..1 Creation date --> <requestProvider><!-- 0..1 Reference(Practitioner) Responsible practitioner --></requestProvider> <requestOrganization><!-- 0..1 Reference(Organization) Responsible organization --></requestOrganization> <request><!-- 0..1 Reference(EligibilityRequest) Eligibility reference --></request> <outcome><!-- 0..1 CodeableConcept complete | error | partial --></outcome> <disposition value="[string]"/><!-- 0..1 Disposition Message --> <insurer><!-- 0..1 Reference(Organization) Insurer --></insurer> <inforce value="[boolean]"/><!-- 0..1 Coverage inforce --> <insurance> <!-- 0..* Details by insurance coverage --> <coverage><!-- 0..1 Reference(Coverage) Updated Coverage details --></coverage> <contract><!-- 0..1 Reference(Contract) Contract details --></contract> <benefitBalance> <!-- 0..* Benefits by Category --> <category><!-- 1..1 CodeableConcept Benefit Category --></category> <subCategory><!-- 0..1 CodeableConcept Benefit SubCategory --></subCategory> <excluded value="[boolean]"/><!-- 0..1 Excluded from the plan --> <name value="[string]"/><!-- 0..1 Short name for the benefit --> <description value="[string]"/><!-- 0..1 Description of the benefit --> <network><!-- 0..1 CodeableConcept In or out of network --></network> <unit><!-- 0..1 CodeableConcept Individual or family --></unit> <term><!-- 0..1 CodeableConcept Annual or lifetime --></term> <financial> <!-- 0..* Benefit Summary --> <type><!-- 1..1 CodeableConcept Deductable, visits, benefit amount --></type> <benefit[x]><!-- 0..1 unsignedInt|string|Money Benefits allowed --></benefit[x]> <benefitUsed[x]><!-- 0..1 unsignedInt|Money Benefits used --></benefitUsed[x]> </financial> </benefitBalance> </insurance> <form><!-- 0..1 CodeableConcept Printed Form Identifier --></form> <error> <!-- 0..* Processing errors --> <code><!-- 1..1 CodeableConcept Error code detailing processing issues --></code> </error> </EligibilityResponse>
JSON Template
{ "resourceType" : "EligibilityResponse", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : [{ Identifier }], // Business Identifier "status" : "<code>", // active | cancelled | draft | entered-in-error "created" : "<dateTime>", // Creation date "requestProvider" : { Reference(Practitioner) }, // Responsible practitioner "requestOrganization" : { Reference(Organization) }, // Responsible organization "request" : { Reference(EligibilityRequest) }, // Eligibility reference "outcome" : { CodeableConcept }, // complete | error | partial "disposition" : "<string>", // Disposition Message "insurer" : { Reference(Organization) }, // Insurer "inforce" : <boolean>, // Coverage inforce "insurance" : [{ // Details by insurance coverage "coverage" : { Reference(Coverage) }, // Updated Coverage details "contract" : { Reference(Contract) }, // Contract details "benefitBalance" : [{ // Benefits by Category "category" : { CodeableConcept }, // R! Benefit Category "subCategory" : { CodeableConcept }, // Benefit SubCategory "excluded" : <boolean>, // Excluded from the plan "name" : "<string>", // Short name for the benefit "description" : "<string>", // Description of the benefit "network" : { CodeableConcept }, // In or out of network "unit" : { CodeableConcept }, // Individual or family "term" : { CodeableConcept }, // Annual or lifetime "financial" : [{ // Benefit Summary "type" : { CodeableConcept }, // R! Deductable, visits, benefit amount // benefit[x]: Benefits allowed. One of these 3: "benefitUnsignedInt" : "<unsignedInt>", "benefitString" : "<string>", "benefitMoney" : { Money }, // benefitUsed[x]: Benefits used. One of these 2: "benefitUsedUnsignedInt" : "<unsignedInt>" "benefitUsedMoney" : { Money } }] }] }], "form" : { CodeableConcept }, // Printed Form Identifier "error" : [{ // Processing errors "code" : { CodeableConcept } // R! Error code detailing processing issues }] }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:EligibilityResponse; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:EligibilityResponse.identifier [ Identifier ], ... ; # 0..* Business Identifier fhir:EligibilityResponse.status [ code ]; # 0..1 active | cancelled | draft | entered-in-error fhir:EligibilityResponse.created [ dateTime ]; # 0..1 Creation date fhir:EligibilityResponse.requestProvider [ Reference(Practitioner) ]; # 0..1 Responsible practitioner fhir:EligibilityResponse.requestOrganization [ Reference(Organization) ]; # 0..1 Responsible organization fhir:EligibilityResponse.request [ Reference(EligibilityRequest) ]; # 0..1 Eligibility reference fhir:EligibilityResponse.outcome [ CodeableConcept ]; # 0..1 complete | error | partial fhir:EligibilityResponse.disposition [ string ]; # 0..1 Disposition Message fhir:EligibilityResponse.insurer [ Reference(Organization) ]; # 0..1 Insurer fhir:EligibilityResponse.inforce [ boolean ]; # 0..1 Coverage inforce fhir:EligibilityResponse.insurance [ # 0..* Details by insurance coverage fhir:EligibilityResponse.insurance.coverage [ Reference(Coverage) ]; # 0..1 Updated Coverage details fhir:EligibilityResponse.insurance.contract [ Reference(Contract) ]; # 0..1 Contract details fhir:EligibilityResponse.insurance.benefitBalance [ # 0..* Benefits by Category fhir:EligibilityResponse.insurance.benefitBalance.category [ CodeableConcept ]; # 1..1 Benefit Category fhir:EligibilityResponse.insurance.benefitBalance.subCategory [ CodeableConcept ]; # 0..1 Benefit SubCategory fhir:EligibilityResponse.insurance.benefitBalance.excluded [ boolean ]; # 0..1 Excluded from the plan fhir:EligibilityResponse.insurance.benefitBalance.name [ string ]; # 0..1 Short name for the benefit fhir:EligibilityResponse.insurance.benefitBalance.description [ string ]; # 0..1 Description of the benefit fhir:EligibilityResponse.insurance.benefitBalance.network [ CodeableConcept ]; # 0..1 In or out of network fhir:EligibilityResponse.insurance.benefitBalance.unit [ CodeableConcept ]; # 0..1 Individual or family fhir:EligibilityResponse.insurance.benefitBalance.term [ CodeableConcept ]; # 0..1 Annual or lifetime fhir:EligibilityResponse.insurance.benefitBalance.financial [ # 0..* Benefit Summary fhir:EligibilityResponse.insurance.benefitBalance.financial.type [ CodeableConcept ]; # 1..1 Deductable, visits, benefit amount # EligibilityResponse.insurance.benefitBalance.financial.benefit[x] : 0..1 Benefits allowed. One of these 3 fhir:EligibilityResponse.insurance.benefitBalance.financial.benefitUnsignedInt [ unsignedInt ] fhir:EligibilityResponse.insurance.benefitBalance.financial.benefitString [ string ] fhir:EligibilityResponse.insurance.benefitBalance.financial.benefitMoney [ Money ] # EligibilityResponse.insurance.benefitBalance.financial.benefitUsed[x] : 0..1 Benefits used. One of these 2 fhir:EligibilityResponse.insurance.benefitBalance.financial.benefitUsedUnsignedInt [ unsignedInt ] fhir:EligibilityResponse.insurance.benefitBalance.financial.benefitUsedMoney [ Money ] ], ...; ], ...; ], ...; fhir:EligibilityResponse.form [ CodeableConcept ]; # 0..1 Printed Form Identifier fhir:EligibilityResponse.error [ # 0..* Processing errors fhir:EligibilityResponse.error.code [ CodeableConcept ]; # 1..1 Error code detailing processing issues ], ...; ]
Changes since DSTU2
EligibilityResponse | |
EligibilityResponse.status | added Element |
EligibilityResponse.outcome | Type changed from code to CodeableConcept |
EligibilityResponse.insurer | added Element |
EligibilityResponse.inforce | added Element |
EligibilityResponse.insurance | added Element |
EligibilityResponse.insurance.coverage | added Element |
EligibilityResponse.insurance.contract | added Element |
EligibilityResponse.insurance.benefitBalance | added Element |
EligibilityResponse.insurance.benefitBalance.category | added Element |
EligibilityResponse.insurance.benefitBalance.subCategory | added Element |
EligibilityResponse.insurance.benefitBalance.excluded | added Element |
EligibilityResponse.insurance.benefitBalance.name | added Element |
EligibilityResponse.insurance.benefitBalance.description | added Element |
EligibilityResponse.insurance.benefitBalance.network | added Element |
EligibilityResponse.insurance.benefitBalance.unit | added Element |
EligibilityResponse.insurance.benefitBalance.term | added Element |
EligibilityResponse.insurance.benefitBalance.financial | added Element |
EligibilityResponse.insurance.benefitBalance.financial.type | added Element |
EligibilityResponse.insurance.benefitBalance.financial.benefit[x] | added Element |
EligibilityResponse.insurance.benefitBalance.financial.benefitUsed[x] | added Element |
EligibilityResponse.form | added Element |
EligibilityResponse.error | added Element |
EligibilityResponse.error.code | added Element |
EligibilityResponse.ruleset | deleted |
EligibilityResponse.originalRuleset | deleted |
EligibilityResponse.organization | deleted |
See the Full Difference for further information
Alternate definitions: Master Definition (XML, JSON), XML Schema/Schematron (for ) + JSON Schema, ShEx (for Turtle), JSON-LD (for RDF as JSON-LD),
Path | Definition | Type | Reference |
---|---|---|---|
EligibilityResponse.status | A code specifying the state of the resource instance. | Required | Financial Resource Status Codes |
EligibilityResponse.outcome | The outcome of the processing. | Required | RemittanceOutcome |
EligibilityResponse.insurance.benefitBalance.category | Benefit categories such as: oral, medical, vision etc. | Example | Benefit Category Codes |
EligibilityResponse.insurance.benefitBalance.subCategory | Benefit subcategories such as: oral-basic, major, glasses | Example | Benefit SubCategory Codes |
EligibilityResponse.insurance.benefitBalance.network | Code to classify in or out of network services | Example | Network Type Codes |
EligibilityResponse.insurance.benefitBalance.unit | Unit covered/serviced - individual or family | Example | Unit Type Codes |
EligibilityResponse.insurance.benefitBalance.term | Coverage unit - annual, lifetime | Example | Benefit Term Codes |
EligibilityResponse.insurance.benefitBalance.financial.type | Deductable, visits, co-pay, etc. | Example | Benefit Type Codes |
EligibilityResponse.form | The forms codes. | Required | Form Codes |
EligibilityResponse.error.code | The error codes for adjudication processing. | Required | Adjudication Error 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 | In Common |
created | date | The creation date | EligibilityResponse.created | |
disposition | string | The contents of the disposition message | EligibilityResponse.disposition | |
identifier | token | The business identifier | EligibilityResponse.identifier | |
insurer | reference | The organization which generated this resource | EligibilityResponse.insurer (Organization) | |
outcome | token | The processing outcome | EligibilityResponse.outcome | |
request | reference | The EligibilityRequest reference | EligibilityResponse.request (EligibilityRequest) | |
request-organization | reference | The EligibilityRequest organization | EligibilityResponse.requestOrganization (Organization) | |
request-provider | reference | The EligibilityRequest provider | EligibilityResponse.requestProvider (Practitioner) |