This page is part of the FHIR Specification (v3.0.2: STU 3). 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: 2 | Trial Use | Compartments: Practitioner |
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 issuing the coverage --></insurer> <inforce value="[boolean]"/><!-- 0..1 Coverage inforce indicator --> <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 Type of services covered --></category> <subCategory><!-- 0..1 CodeableConcept Detailed services covered within the type --></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 or services covered --> <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> <allowed[x]><!-- 0..1 unsignedInt|string|Money Benefits allowed --></allowed[x]> <used[x]><!-- 0..1 unsignedInt|Money Benefits used --></used[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 issuing the coverage "inforce" : <boolean>, // Coverage inforce indicator "insurance" : [{ // Details by insurance coverage "coverage" : { Reference(Coverage) }, // Updated Coverage details "contract" : { Reference(Contract) }, // Contract details "benefitBalance" : [{ // Benefits by Category "category" : { CodeableConcept }, // R! Type of services covered "subCategory" : { CodeableConcept }, // Detailed services covered within the type "excluded" : <boolean>, // Excluded from the plan "name" : "<string>", // Short name for the benefit "description" : "<string>", // Description of the benefit or services covered "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 // allowed[x]: Benefits allowed. One of these 3: "allowedUnsignedInt" : "<unsignedInt>", "allowedString" : "<string>", "allowedMoney" : { Money }, // used[x]: Benefits used. One of these 2: "usedUnsignedInt" : "<unsignedInt>" "usedMoney" : { 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 issuing the coverage fhir:EligibilityResponse.inforce [ boolean ]; # 0..1 Coverage inforce indicator 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 Type of services covered fhir:EligibilityResponse.insurance.benefitBalance.subCategory [ CodeableConcept ]; # 0..1 Detailed services covered within the type 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 or services covered 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.allowed[x] : 0..1 Benefits allowed. One of these 3 fhir:EligibilityResponse.insurance.benefitBalance.financial.allowedUnsignedInt [ unsignedInt ] fhir:EligibilityResponse.insurance.benefitBalance.financial.allowedString [ string ] fhir:EligibilityResponse.insurance.benefitBalance.financial.allowedMoney [ Money ] # EligibilityResponse.insurance.benefitBalance.financial.used[x] : 0..1 Benefits used. One of these 2 fhir:EligibilityResponse.insurance.benefitBalance.financial.usedUnsignedInt [ unsignedInt ] fhir:EligibilityResponse.insurance.benefitBalance.financial.usedMoney [ 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 |
|
EligibilityResponse.outcome |
|
EligibilityResponse.insurer |
|
EligibilityResponse.inforce |
|
EligibilityResponse.insurance |
|
EligibilityResponse.insurance.coverage |
|
EligibilityResponse.insurance.contract |
|
EligibilityResponse.insurance.benefitBalance |
|
EligibilityResponse.insurance.benefitBalance.category |
|
EligibilityResponse.insurance.benefitBalance.subCategory |
|
EligibilityResponse.insurance.benefitBalance.excluded |
|
EligibilityResponse.insurance.benefitBalance.name |
|
EligibilityResponse.insurance.benefitBalance.description |
|
EligibilityResponse.insurance.benefitBalance.network |
|
EligibilityResponse.insurance.benefitBalance.unit |
|
EligibilityResponse.insurance.benefitBalance.term |
|
EligibilityResponse.insurance.benefitBalance.financial |
|
EligibilityResponse.insurance.benefitBalance.financial.type |
|
EligibilityResponse.insurance.benefitBalance.financial.allowed[x] |
|
EligibilityResponse.insurance.benefitBalance.financial.used[x] |
|
EligibilityResponse.form |
|
EligibilityResponse.error |
|
EligibilityResponse.error.code |
|
EligibilityResponse.ruleset |
|
EligibilityResponse.originalRuleset |
|
EligibilityResponse.organization |
|
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 issuing the coverage --></insurer> <inforce value="[boolean]"/><!-- 0..1 Coverage inforce indicator --> <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 Type of services covered --></category> <subCategory><!-- 0..1 CodeableConcept Detailed services covered within the type --></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 or services covered --> <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> <allowed[x]><!-- 0..1 unsignedInt|string|Money Benefits allowed --></allowed[x]> <used[x]><!-- 0..1 unsignedInt|Money Benefits used --></used[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 issuing the coverage "inforce" : <boolean>, // Coverage inforce indicator "insurance" : [{ // Details by insurance coverage "coverage" : { Reference(Coverage) }, // Updated Coverage details "contract" : { Reference(Contract) }, // Contract details "benefitBalance" : [{ // Benefits by Category "category" : { CodeableConcept }, // R! Type of services covered "subCategory" : { CodeableConcept }, // Detailed services covered within the type "excluded" : <boolean>, // Excluded from the plan "name" : "<string>", // Short name for the benefit "description" : "<string>", // Description of the benefit or services covered "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 // allowed[x]: Benefits allowed. One of these 3: "allowedUnsignedInt" : "<unsignedInt>", "allowedString" : "<string>", "allowedMoney" : { Money }, // used[x]: Benefits used. One of these 2: "usedUnsignedInt" : "<unsignedInt>" "usedMoney" : { 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 issuing the coverage fhir:EligibilityResponse.inforce [ boolean ]; # 0..1 Coverage inforce indicator 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 Type of services covered fhir:EligibilityResponse.insurance.benefitBalance.subCategory [ CodeableConcept ]; # 0..1 Detailed services covered within the type 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 or services covered 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.allowed[x] : 0..1 Benefits allowed. One of these 3 fhir:EligibilityResponse.insurance.benefitBalance.financial.allowedUnsignedInt [ unsignedInt ] fhir:EligibilityResponse.insurance.benefitBalance.financial.allowedString [ string ] fhir:EligibilityResponse.insurance.benefitBalance.financial.allowedMoney [ Money ] # EligibilityResponse.insurance.benefitBalance.financial.used[x] : 0..1 Benefits used. One of these 2 fhir:EligibilityResponse.insurance.benefitBalance.financial.usedUnsignedInt [ unsignedInt ] fhir:EligibilityResponse.insurance.benefitBalance.financial.usedMoney [ 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 |
|
EligibilityResponse.outcome |
|
EligibilityResponse.insurer |
|
EligibilityResponse.inforce |
|
EligibilityResponse.insurance |
|
EligibilityResponse.insurance.coverage |
|
EligibilityResponse.insurance.contract |
|
EligibilityResponse.insurance.benefitBalance |
|
EligibilityResponse.insurance.benefitBalance.category |
|
EligibilityResponse.insurance.benefitBalance.subCategory |
|
EligibilityResponse.insurance.benefitBalance.excluded |
|
EligibilityResponse.insurance.benefitBalance.name |
|
EligibilityResponse.insurance.benefitBalance.description |
|
EligibilityResponse.insurance.benefitBalance.network |
|
EligibilityResponse.insurance.benefitBalance.unit |
|
EligibilityResponse.insurance.benefitBalance.term |
|
EligibilityResponse.insurance.benefitBalance.financial |
|
EligibilityResponse.insurance.benefitBalance.financial.type |
|
EligibilityResponse.insurance.benefitBalance.financial.allowed[x] |
|
EligibilityResponse.insurance.benefitBalance.financial.used[x] |
|
EligibilityResponse.form |
|
EligibilityResponse.error |
|
EligibilityResponse.error.code |
|
EligibilityResponse.ruleset |
|
EligibilityResponse.originalRuleset |
|
EligibilityResponse.organization |
|
See the Full Difference for further information
Alternate definitions: Master Definition (XML, JSON), XML Schema/Schematron (for ) + JSON Schema, ShEx (for Turtle)
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. | Example | Form Codes |
EligibilityResponse.error.code | The error codes for adjudication processing. | Example | 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 | Expression | 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) |