Current Build

13.3 Resource EligibilityResponse - Content

Financial Management Work GroupMaturity 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.

For Balloters: The optional Authorization subclass has been addded for comment ballot review. The EligibilityResponse would return a boolean indicating whether pre-authorization is required and an optional text element woud convey and special instructions for each of the billable services provided in the EligibilityRequest.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. EligibilityResponse TUDomainResourceEligibilityResponse resource
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier 0..*IdentifierBusiness Identifier
... status ?!Σ0..1codeactive | cancelled | draft | entered-in-error
Financial Resource Status Codes (Required)
... use Σ1..*codeauth-requirements | benefits | discovery | validation
EligibilityResponseUse (Required)
... patient 0..1Reference(Patient)The subject of the Products and Services
... serviced[x] 0..1Estimated date or dates for inquiry
.... servicedDatedate
.... servicedPeriodPeriod
... created 0..1dateTimeCreation date
... requestProvider 0..1Reference(Practitioner | PractitionerRole | Organization)Responsible provider
... request 0..1Reference(EligibilityRequest)Eligibility reference
... outcome 0..1codequeued | complete | error | partial
RemittanceOutcome (Required)
... disposition 0..1stringDisposition Message
... insurer 0..1Reference(Organization)Insurer issuing the coverage
... insurance 0..*BackboneElementDetails by insurance coverage
.... coverage 0..1Reference(Coverage)Updated Coverage details
.... contract 0..1Reference(Contract)Contract details
.... inforce 0..1booleanCoverage inforce indicator
.... detail I0..*BackboneElementBenefits and Authorization requirements by Category or Service
+ SHALL contain a service for modifier to be present.
+ SHALL contain a category or a service but not both.
..... category 0..1CodeableConceptType of service
Benefit Category Codes (Example)
..... service 0..1CodeableConceptBilling Code
USCLS Codes (Example)
..... modifier 0..*CodeableConceptService/Product billing modifiers
Modifier type Codes (Example)
..... provider 0..1Reference(Practitioner | PractitionerRole)Performing practitioner
..... excluded 0..1booleanExcluded from the plan
..... name 0..1stringShort name for the benefit
..... description 0..1stringDescription of the benefit or services covered
..... network 0..1CodeableConceptIn or out of network
Network Type Codes (Example)
..... unit 0..1CodeableConceptIndividual or family
Unit Type Codes (Example)
..... term 0..1CodeableConceptAnnual or lifetime
Benefit Term Codes (Example)
..... benefit 0..*BackboneElementBenefit Summary
...... type 1..1CodeableConceptDeductable, visits, benefit amount
Benefit Type Codes (Example)
...... allowed[x] 0..1Benefits allowed
....... allowedUnsignedIntunsignedInt
....... allowedStringstring
....... allowedMoneyMoney
...... used[x] 0..1Benefits used
....... usedUnsignedIntunsignedInt
....... usedMoneyMoney
..... authorizationRequired 0..1booleanAuthorization required flag
..... authorizationSupporting 0..*CodeableConceptCodes or text of materials to be submitted
..... authorizationUrl 0..1uriPre-authorization requirements
... preAuthRef 0..1stringPre-Authorization/Determination Reference
... form 0..1CodeableConceptPrinted Form Identifier
Form Codes (Example)
... error 0..*BackboneElementProcessing errors
.... code 1..1CodeableConceptError code detailing processing issues
Adjudication Error Codes (Example)

doco Documentation for this format

UML Diagram (Legend)

EligibilityResponse (DomainResource)The Response business identifieridentifier : Identifier [0..*]The status of the resource instance (this element modifies the meaning of other elements)status : code [0..1] « A code specifying the state of the resource instance. (Strength=Required)Financial Resource Status ! »Specify whether requesting: prior authorization requirements for some service categories or billing codes; benefits for coverages specified or discovered; discovery and return of coverages for th patient; and/or validation that the specified coverage is in-force at the date/period specified or 'now' if not specifieduse : code [1..*] « A code specifying the types of information being requested. (Strength=Required)EligibilityResponseUse! »Patient Resourcepatient : Reference [0..1] « Patient »The date or dates when the enclosed suite of services are proposed and for which coverage details are requestedserviced[x] : Type [0..1] « date|Period »The date when the enclosed suite of services were performed or completedcreated : dateTime [0..1]The provider who is responsible for the services rendered to the patientrequestProvider : Reference [0..1] « Practitioner|PractitionerRole| Organization »Original request resource referencerequest : Reference [0..1] « EligibilityRequest »Transaction status: error, completeoutcome : code [0..1] « The outcome of the processing. (Strength=Required)RemittanceOutcome! »A description of the status of the adjudicationdisposition : string [0..1]The Insurer who produced this adjudicated responseinsurer : Reference [0..1] « Organization »A reference from the Insurer to which these services pertainpreAuthRef : string [0..1]The form to be used for printing the contentform : CodeableConcept [0..1] « The forms codes. (Strength=Example)Form ?? »InsuranceA suite of updated or additional Coverages from the Insurercoverage : Reference [0..1] « Coverage »The contract resource which may provide more detailed informationcontract : Reference [0..1] « Contract »Flag indicating if the coverage provided is inforce currently if no service date(s) specified or for the whole duration of the service datesinforce : boolean [0..1]DetailsHigh-level Dental, Vision, Medical, Pharmacy, Rehab etc. and detailed types of services: Dental: basic, major, ortho; Vision exam, glasses, contacts; etccategory : CodeableConcept [0..1] « Benefit categories such as: oral, medical, vision etc. (Strength=Example)Benefit Category ?? »A code to indicate the Professional Service or Product supplied (eg. CTP, HCPCS,USCLS,ICD10, NCPDP,DIN,ACHI,CCI)service : CodeableConcept [0..1] « Allowable service and product codes (Strength=Example)USCLS ?? »Item typification or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or for medical whether the treatment was outside the clinic or out of office hoursmodifier : CodeableConcept [0..*] « Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen. (Strength=Example)Modifier type ?? »The practitioner who is responsible for the services rendered to the patientprovider : Reference [0..1] « Practitioner|PractitionerRole »True if the indicated class of service is excluded from the plan, missing or False indicated the service is included in the coverageexcluded : boolean [0..1]A short name or tag for the benefit, for example MED01, or DENT2name : string [0..1]A richer description of the benefit, for example 'DENT2 covers 100% of basic, 50% of major but exclused Ortho, Implants and Costmetic services'description : string [0..1]Network designationnetwork : CodeableConcept [0..1] « Code to classify in or out of network services (Strength=Example)Network Type ?? »Unit designation: individual or familyunit : CodeableConcept [0..1] « Unit covered/serviced - individual or family (Strength=Example)Unit Type ?? »The term or period of the values such as 'maximum lifetime benefit' or 'maximum annual vistis'term : CodeableConcept [0..1] « Coverage unit - annual, lifetime (Strength=Example)Benefit Term ?? »A boolean flag indicating whether a prior authorization or pre-authorization is required prior to actual service deliveryauthorizationRequired : boolean [0..1]Codes or comments regarding information or actions assciated with the pre-authorizationauthorizationSupporting : CodeableConcept [0..*]A descriptive document locationauthorizationUrl : uri [0..1]BenefitDeductable, visits, benefit amounttype : CodeableConcept [1..1] « Deductable, visits, co-pay, etc. (Strength=Example)Benefit Type ?? »Benefits allowedallowed[x] : Type [0..1] « unsignedInt|string|Money »Benefits usedused[x] : Type [0..1] « unsignedInt|Money »ErrorsAn error code,from a specified code system, which details why the eligibility check could not be performedcode : CodeableConcept [1..1] « The error codes for adjudication processing. (Strength=Example)Adjudication Error ?? »Benefits Used to datebenefit[0..*]Benefits and optionally current balances by Category or Servicedetail[0..*]The insurer may provide both the details for the requested coverage as well as details for additional coverages known to the insurerinsurance[0..*]Mutually exclusive with Services Provided (Item)error[0..*]

XML Template

<EligibilityResponse xmlns="http://hl7.org/fhir"> doco
 <!-- 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 -->
 <use value="[code]"/><!-- 1..* auth-requirements | benefits | discovery | validation -->
 <patient><!-- 0..1 Reference(Patient) The subject of the Products and Services --></patient>
 <serviced[x]><!-- 0..1 date|Period Estimated date or dates for inquiry --></serviced[x]>
 <created value="[dateTime]"/><!-- 0..1 Creation date -->
 <requestProvider><!-- 0..1 Reference(Practitioner|PractitionerRole|Organization) Responsible provider --></requestProvider>
 <request><!-- 0..1 Reference(EligibilityRequest) Eligibility reference --></request>
 <outcome value="[code]"/><!-- 0..1 queued | complete | error | partial -->
 <disposition value="[string]"/><!-- 0..1 Disposition Message -->
 <insurer><!-- 0..1 Reference(Organization) Insurer issuing the coverage --></insurer>
 <insurance>  <!-- 0..* Details by insurance coverage -->
  <coverage><!-- 0..1 Reference(Coverage) Updated Coverage details --></coverage>
  <contract><!-- 0..1 Reference(Contract) Contract details --></contract>
  <inforce value="[boolean]"/><!-- 0..1 Coverage inforce indicator -->
  <detail>  <!-- 0..* Benefits and Authorization requirements by Category or Service -->
   <category><!-- 0..1 CodeableConcept Type of service --></category>
   <service><!-- 0..1 CodeableConcept Billing Code --></service>
   <modifier><!-- 0..* CodeableConcept Service/Product billing modifiers --></modifier>
   <provider><!-- 0..1 Reference(Practitioner|PractitionerRole) Performing practitioner --></provider>
   <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>
   <benefit>  <!-- 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]>
   </benefit>
   <authorizationRequired value="[boolean]"/><!-- 0..1 Authorization required flag -->
   <authorizationSupporting><!-- 0..* CodeableConcept Codes or text of materials to be submitted --></authorizationSupporting>
   <authorizationUrl value="[uri]"/><!-- 0..1 Pre-authorization requirements -->
  </detail>
 </insurance>
 <preAuthRef value="[string]"/><!-- 0..1 Pre-Authorization/Determination Reference -->
 <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

{doco
  "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
  "use" : ["<code>"], // R!  auth-requirements | benefits | discovery | validation
  "patient" : { Reference(Patient) }, // The subject of the Products and Services
  // serviced[x]: Estimated date or dates for inquiry. One of these 2:
  "servicedDate" : "<date>",
  "servicedPeriod" : { Period },
  "created" : "<dateTime>", // Creation date
  "requestProvider" : { Reference(Practitioner|PractitionerRole|Organization) }, // Responsible provider
  "request" : { Reference(EligibilityRequest) }, // Eligibility reference
  "outcome" : "<code>", // queued | complete | error | partial
  "disposition" : "<string>", // Disposition Message
  "insurer" : { Reference(Organization) }, // Insurer issuing the coverage
  "insurance" : [{ // Details by insurance coverage
    "coverage" : { Reference(Coverage) }, // Updated Coverage details
    "contract" : { Reference(Contract) }, // Contract details
    "inforce" : <boolean>, // Coverage inforce indicator
    "detail" : [{ // Benefits and Authorization requirements by Category or Service
      "category" : { CodeableConcept }, // Type of service
      "service" : { CodeableConcept }, // Billing Code
      "modifier" : [{ CodeableConcept }], // Service/Product billing modifiers
      "provider" : { Reference(Practitioner|PractitionerRole) }, // Performing practitioner
      "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
      "benefit" : [{ // 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 }
      }],
      "authorizationRequired" : <boolean>, // Authorization required flag
      "authorizationSupporting" : [{ CodeableConcept }], // Codes or text of materials to be submitted
      "authorizationUrl" : "<uri>" // Pre-authorization requirements
    }]
  }],
  "preAuthRef" : "<string>", // Pre-Authorization/Determination Reference
  "form" : { CodeableConcept }, // Printed Form Identifier
  "error" : [{ // Processing errors
    "code" : { CodeableConcept } // R!  Error code detailing processing issues
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ 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.use [ code ], ... ; # 1..* auth-requirements | benefits | discovery | validation
  fhir:EligibilityResponse.patient [ Reference(Patient) ]; # 0..1 The subject of the Products and Services
  # EligibilityResponse.serviced[x] : 0..1 Estimated date or dates for inquiry. One of these 2
    fhir:EligibilityResponse.servicedDate [ date ]
    fhir:EligibilityResponse.servicedPeriod [ Period ]
  fhir:EligibilityResponse.created [ dateTime ]; # 0..1 Creation date
  fhir:EligibilityResponse.requestProvider [ Reference(Practitioner|PractitionerRole|Organization) ]; # 0..1 Responsible provider
  fhir:EligibilityResponse.request [ Reference(EligibilityRequest) ]; # 0..1 Eligibility reference
  fhir:EligibilityResponse.outcome [ code ]; # 0..1 queued | complete | error | partial
  fhir:EligibilityResponse.disposition [ string ]; # 0..1 Disposition Message
  fhir:EligibilityResponse.insurer [ Reference(Organization) ]; # 0..1 Insurer issuing the coverage
  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.inforce [ boolean ]; # 0..1 Coverage inforce indicator
    fhir:EligibilityResponse.insurance.detail [ # 0..* Benefits and Authorization requirements by Category or Service
      fhir:EligibilityResponse.insurance.detail.category [ CodeableConcept ]; # 0..1 Type of service
      fhir:EligibilityResponse.insurance.detail.service [ CodeableConcept ]; # 0..1 Billing Code
      fhir:EligibilityResponse.insurance.detail.modifier [ CodeableConcept ], ... ; # 0..* Service/Product billing modifiers
      fhir:EligibilityResponse.insurance.detail.provider [ Reference(Practitioner|PractitionerRole) ]; # 0..1 Performing practitioner
      fhir:EligibilityResponse.insurance.detail.excluded [ boolean ]; # 0..1 Excluded from the plan
      fhir:EligibilityResponse.insurance.detail.name [ string ]; # 0..1 Short name for the benefit
      fhir:EligibilityResponse.insurance.detail.description [ string ]; # 0..1 Description of the benefit or services covered
      fhir:EligibilityResponse.insurance.detail.network [ CodeableConcept ]; # 0..1 In or out of network
      fhir:EligibilityResponse.insurance.detail.unit [ CodeableConcept ]; # 0..1 Individual or family
      fhir:EligibilityResponse.insurance.detail.term [ CodeableConcept ]; # 0..1 Annual or lifetime
      fhir:EligibilityResponse.insurance.detail.benefit [ # 0..* Benefit Summary
        fhir:EligibilityResponse.insurance.detail.benefit.type [ CodeableConcept ]; # 1..1 Deductable, visits, benefit amount
        # EligibilityResponse.insurance.detail.benefit.allowed[x] : 0..1 Benefits allowed. One of these 3
          fhir:EligibilityResponse.insurance.detail.benefit.allowedUnsignedInt [ unsignedInt ]
          fhir:EligibilityResponse.insurance.detail.benefit.allowedString [ string ]
          fhir:EligibilityResponse.insurance.detail.benefit.allowedMoney [ Money ]
        # EligibilityResponse.insurance.detail.benefit.used[x] : 0..1 Benefits used. One of these 2
          fhir:EligibilityResponse.insurance.detail.benefit.usedUnsignedInt [ unsignedInt ]
          fhir:EligibilityResponse.insurance.detail.benefit.usedMoney [ Money ]
      ], ...;
      fhir:EligibilityResponse.insurance.detail.authorizationRequired [ boolean ]; # 0..1 Authorization required flag
      fhir:EligibilityResponse.insurance.detail.authorizationSupporting [ CodeableConcept ], ... ; # 0..* Codes or text of materials to be submitted
      fhir:EligibilityResponse.insurance.detail.authorizationUrl [ uri ]; # 0..1 Pre-authorization requirements
    ], ...;
  ], ...;
  fhir:EligibilityResponse.preAuthRef [ string ]; # 0..1 Pre-Authorization/Determination Reference
  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 R3

EligibilityResponse
EligibilityResponse.use
  • Added Element
EligibilityResponse.patient
  • Added Element
EligibilityResponse.serviced[x]
  • Added Element
EligibilityResponse.requestProvider
  • Type changed from Reference(Practitioner) to Reference(Practitioner|PractitionerRole|Organization)
EligibilityResponse.outcome
  • Type changed from CodeableConcept to code
EligibilityResponse.insurance.inforce
  • Added Element
EligibilityResponse.insurance.detail
  • Added Element
EligibilityResponse.insurance.detail.category
  • Added Element
EligibilityResponse.insurance.detail.service
  • Added Element
EligibilityResponse.insurance.detail.modifier
  • Added Element
EligibilityResponse.insurance.detail.provider
  • Added Element
EligibilityResponse.insurance.detail.excluded
  • Added Element
EligibilityResponse.insurance.detail.name
  • Added Element
EligibilityResponse.insurance.detail.description
  • Added Element
EligibilityResponse.insurance.detail.network
  • Added Element
EligibilityResponse.insurance.detail.unit
  • Added Element
EligibilityResponse.insurance.detail.term
  • Added Element
EligibilityResponse.insurance.detail.benefit
  • Added Element
EligibilityResponse.insurance.detail.benefit.type
  • Added Element
EligibilityResponse.insurance.detail.benefit.allowed[x]
  • Added Element
EligibilityResponse.insurance.detail.benefit.used[x]
  • Added Element
EligibilityResponse.insurance.detail.authorizationRequired
  • Added Element
EligibilityResponse.insurance.detail.authorizationSupporting
  • Added Element
EligibilityResponse.insurance.detail.authorizationUrl
  • Added Element
EligibilityResponse.preAuthRef
  • Added Element
EligibilityResponse.requestOrganization
  • deleted
EligibilityResponse.inforce
  • deleted
EligibilityResponse.insurance.benefitBalance
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. EligibilityResponse TUDomainResourceEligibilityResponse resource
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier 0..*IdentifierBusiness Identifier
... status ?!Σ0..1codeactive | cancelled | draft | entered-in-error
Financial Resource Status Codes (Required)
... use Σ1..*codeauth-requirements | benefits | discovery | validation
EligibilityResponseUse (Required)
... patient 0..1Reference(Patient)The subject of the Products and Services
... serviced[x] 0..1Estimated date or dates for inquiry
.... servicedDatedate
.... servicedPeriodPeriod
... created 0..1dateTimeCreation date
... requestProvider 0..1Reference(Practitioner | PractitionerRole | Organization)Responsible provider
... request 0..1Reference(EligibilityRequest)Eligibility reference
... outcome 0..1codequeued | complete | error | partial
RemittanceOutcome (Required)
... disposition 0..1stringDisposition Message
... insurer 0..1Reference(Organization)Insurer issuing the coverage
... insurance 0..*BackboneElementDetails by insurance coverage
.... coverage 0..1Reference(Coverage)Updated Coverage details
.... contract 0..1Reference(Contract)Contract details
.... inforce 0..1booleanCoverage inforce indicator
.... detail I0..*BackboneElementBenefits and Authorization requirements by Category or Service
+ SHALL contain a service for modifier to be present.
+ SHALL contain a category or a service but not both.
..... category 0..1CodeableConceptType of service
Benefit Category Codes (Example)
..... service 0..1CodeableConceptBilling Code
USCLS Codes (Example)
..... modifier 0..*CodeableConceptService/Product billing modifiers
Modifier type Codes (Example)
..... provider 0..1Reference(Practitioner | PractitionerRole)Performing practitioner
..... excluded 0..1booleanExcluded from the plan
..... name 0..1stringShort name for the benefit
..... description 0..1stringDescription of the benefit or services covered
..... network 0..1CodeableConceptIn or out of network
Network Type Codes (Example)
..... unit 0..1CodeableConceptIndividual or family
Unit Type Codes (Example)
..... term 0..1CodeableConceptAnnual or lifetime
Benefit Term Codes (Example)
..... benefit 0..*BackboneElementBenefit Summary
...... type 1..1CodeableConceptDeductable, visits, benefit amount
Benefit Type Codes (Example)
...... allowed[x] 0..1Benefits allowed
....... allowedUnsignedIntunsignedInt
....... allowedStringstring
....... allowedMoneyMoney
...... used[x] 0..1Benefits used
....... usedUnsignedIntunsignedInt
....... usedMoneyMoney
..... authorizationRequired 0..1booleanAuthorization required flag
..... authorizationSupporting 0..*CodeableConceptCodes or text of materials to be submitted
..... authorizationUrl 0..1uriPre-authorization requirements
... preAuthRef 0..1stringPre-Authorization/Determination Reference
... form 0..1CodeableConceptPrinted Form Identifier
Form Codes (Example)
... error 0..*BackboneElementProcessing errors
.... code 1..1CodeableConceptError code detailing processing issues
Adjudication Error Codes (Example)

doco Documentation for this format

UML Diagram (Legend)

EligibilityResponse (DomainResource)The Response business identifieridentifier : Identifier [0..*]The status of the resource instance (this element modifies the meaning of other elements)status : code [0..1] « A code specifying the state of the resource instance. (Strength=Required)Financial Resource Status ! »Specify whether requesting: prior authorization requirements for some service categories or billing codes; benefits for coverages specified or discovered; discovery and return of coverages for th patient; and/or validation that the specified coverage is in-force at the date/period specified or 'now' if not specifieduse : code [1..*] « A code specifying the types of information being requested. (Strength=Required)EligibilityResponseUse! »Patient Resourcepatient : Reference [0..1] « Patient »The date or dates when the enclosed suite of services are proposed and for which coverage details are requestedserviced[x] : Type [0..1] « date|Period »The date when the enclosed suite of services were performed or completedcreated : dateTime [0..1]The provider who is responsible for the services rendered to the patientrequestProvider : Reference [0..1] « Practitioner|PractitionerRole| Organization »Original request resource referencerequest : Reference [0..1] « EligibilityRequest »Transaction status: error, completeoutcome : code [0..1] « The outcome of the processing. (Strength=Required)RemittanceOutcome! »A description of the status of the adjudicationdisposition : string [0..1]The Insurer who produced this adjudicated responseinsurer : Reference [0..1] « Organization »A reference from the Insurer to which these services pertainpreAuthRef : string [0..1]The form to be used for printing the contentform : CodeableConcept [0..1] « The forms codes. (Strength=Example)Form ?? »InsuranceA suite of updated or additional Coverages from the Insurercoverage : Reference [0..1] « Coverage »The contract resource which may provide more detailed informationcontract : Reference [0..1] « Contract »Flag indicating if the coverage provided is inforce currently if no service date(s) specified or for the whole duration of the service datesinforce : boolean [0..1]DetailsHigh-level Dental, Vision, Medical, Pharmacy, Rehab etc. and detailed types of services: Dental: basic, major, ortho; Vision exam, glasses, contacts; etccategory : CodeableConcept [0..1] « Benefit categories such as: oral, medical, vision etc. (Strength=Example)Benefit Category ?? »A code to indicate the Professional Service or Product supplied (eg. CTP, HCPCS,USCLS,ICD10, NCPDP,DIN,ACHI,CCI)service : CodeableConcept [0..1] « Allowable service and product codes (Strength=Example)USCLS ?? »Item typification or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or for medical whether the treatment was outside the clinic or out of office hoursmodifier : CodeableConcept [0..*] « Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen. (Strength=Example)Modifier type ?? »The practitioner who is responsible for the services rendered to the patientprovider : Reference [0..1] « Practitioner|PractitionerRole »True if the indicated class of service is excluded from the plan, missing or False indicated the service is included in the coverageexcluded : boolean [0..1]A short name or tag for the benefit, for example MED01, or DENT2name : string [0..1]A richer description of the benefit, for example 'DENT2 covers 100% of basic, 50% of major but exclused Ortho, Implants and Costmetic services'description : string [0..1]Network designationnetwork : CodeableConcept [0..1] « Code to classify in or out of network services (Strength=Example)Network Type ?? »Unit designation: individual or familyunit : CodeableConcept [0..1] « Unit covered/serviced - individual or family (Strength=Example)Unit Type ?? »The term or period of the values such as 'maximum lifetime benefit' or 'maximum annual vistis'term : CodeableConcept [0..1] « Coverage unit - annual, lifetime (Strength=Example)Benefit Term ?? »A boolean flag indicating whether a prior authorization or pre-authorization is required prior to actual service deliveryauthorizationRequired : boolean [0..1]Codes or comments regarding information or actions assciated with the pre-authorizationauthorizationSupporting : CodeableConcept [0..*]A descriptive document locationauthorizationUrl : uri [0..1]BenefitDeductable, visits, benefit amounttype : CodeableConcept [1..1] « Deductable, visits, co-pay, etc. (Strength=Example)Benefit Type ?? »Benefits allowedallowed[x] : Type [0..1] « unsignedInt|string|Money »Benefits usedused[x] : Type [0..1] « unsignedInt|Money »ErrorsAn error code,from a specified code system, which details why the eligibility check could not be performedcode : CodeableConcept [1..1] « The error codes for adjudication processing. (Strength=Example)Adjudication Error ?? »Benefits Used to datebenefit[0..*]Benefits and optionally current balances by Category or Servicedetail[0..*]The insurer may provide both the details for the requested coverage as well as details for additional coverages known to the insurerinsurance[0..*]Mutually exclusive with Services Provided (Item)error[0..*]

XML Template

<EligibilityResponse xmlns="http://hl7.org/fhir"> doco
 <!-- 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 -->
 <use value="[code]"/><!-- 1..* auth-requirements | benefits | discovery | validation -->
 <patient><!-- 0..1 Reference(Patient) The subject of the Products and Services --></patient>
 <serviced[x]><!-- 0..1 date|Period Estimated date or dates for inquiry --></serviced[x]>
 <created value="[dateTime]"/><!-- 0..1 Creation date -->
 <requestProvider><!-- 0..1 Reference(Practitioner|PractitionerRole|Organization) Responsible provider --></requestProvider>
 <request><!-- 0..1 Reference(EligibilityRequest) Eligibility reference --></request>
 <outcome value="[code]"/><!-- 0..1 queued | complete | error | partial -->
 <disposition value="[string]"/><!-- 0..1 Disposition Message -->
 <insurer><!-- 0..1 Reference(Organization) Insurer issuing the coverage --></insurer>
 <insurance>  <!-- 0..* Details by insurance coverage -->
  <coverage><!-- 0..1 Reference(Coverage) Updated Coverage details --></coverage>
  <contract><!-- 0..1 Reference(Contract) Contract details --></contract>
  <inforce value="[boolean]"/><!-- 0..1 Coverage inforce indicator -->
  <detail>  <!-- 0..* Benefits and Authorization requirements by Category or Service -->
   <category><!-- 0..1 CodeableConcept Type of service --></category>
   <service><!-- 0..1 CodeableConcept Billing Code --></service>
   <modifier><!-- 0..* CodeableConcept Service/Product billing modifiers --></modifier>
   <provider><!-- 0..1 Reference(Practitioner|PractitionerRole) Performing practitioner --></provider>
   <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>
   <benefit>  <!-- 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]>
   </benefit>
   <authorizationRequired value="[boolean]"/><!-- 0..1 Authorization required flag -->
   <authorizationSupporting><!-- 0..* CodeableConcept Codes or text of materials to be submitted --></authorizationSupporting>
   <authorizationUrl value="[uri]"/><!-- 0..1 Pre-authorization requirements -->
  </detail>
 </insurance>
 <preAuthRef value="[string]"/><!-- 0..1 Pre-Authorization/Determination Reference -->
 <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

{doco
  "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
  "use" : ["<code>"], // R!  auth-requirements | benefits | discovery | validation
  "patient" : { Reference(Patient) }, // The subject of the Products and Services
  // serviced[x]: Estimated date or dates for inquiry. One of these 2:
  "servicedDate" : "<date>",
  "servicedPeriod" : { Period },
  "created" : "<dateTime>", // Creation date
  "requestProvider" : { Reference(Practitioner|PractitionerRole|Organization) }, // Responsible provider
  "request" : { Reference(EligibilityRequest) }, // Eligibility reference
  "outcome" : "<code>", // queued | complete | error | partial
  "disposition" : "<string>", // Disposition Message
  "insurer" : { Reference(Organization) }, // Insurer issuing the coverage
  "insurance" : [{ // Details by insurance coverage
    "coverage" : { Reference(Coverage) }, // Updated Coverage details
    "contract" : { Reference(Contract) }, // Contract details
    "inforce" : <boolean>, // Coverage inforce indicator
    "detail" : [{ // Benefits and Authorization requirements by Category or Service
      "category" : { CodeableConcept }, // Type of service
      "service" : { CodeableConcept }, // Billing Code
      "modifier" : [{ CodeableConcept }], // Service/Product billing modifiers
      "provider" : { Reference(Practitioner|PractitionerRole) }, // Performing practitioner
      "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
      "benefit" : [{ // 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 }
      }],
      "authorizationRequired" : <boolean>, // Authorization required flag
      "authorizationSupporting" : [{ CodeableConcept }], // Codes or text of materials to be submitted
      "authorizationUrl" : "<uri>" // Pre-authorization requirements
    }]
  }],
  "preAuthRef" : "<string>", // Pre-Authorization/Determination Reference
  "form" : { CodeableConcept }, // Printed Form Identifier
  "error" : [{ // Processing errors
    "code" : { CodeableConcept } // R!  Error code detailing processing issues
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ 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.use [ code ], ... ; # 1..* auth-requirements | benefits | discovery | validation
  fhir:EligibilityResponse.patient [ Reference(Patient) ]; # 0..1 The subject of the Products and Services
  # EligibilityResponse.serviced[x] : 0..1 Estimated date or dates for inquiry. One of these 2
    fhir:EligibilityResponse.servicedDate [ date ]
    fhir:EligibilityResponse.servicedPeriod [ Period ]
  fhir:EligibilityResponse.created [ dateTime ]; # 0..1 Creation date
  fhir:EligibilityResponse.requestProvider [ Reference(Practitioner|PractitionerRole|Organization) ]; # 0..1 Responsible provider
  fhir:EligibilityResponse.request [ Reference(EligibilityRequest) ]; # 0..1 Eligibility reference
  fhir:EligibilityResponse.outcome [ code ]; # 0..1 queued | complete | error | partial
  fhir:EligibilityResponse.disposition [ string ]; # 0..1 Disposition Message
  fhir:EligibilityResponse.insurer [ Reference(Organization) ]; # 0..1 Insurer issuing the coverage
  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.inforce [ boolean ]; # 0..1 Coverage inforce indicator
    fhir:EligibilityResponse.insurance.detail [ # 0..* Benefits and Authorization requirements by Category or Service
      fhir:EligibilityResponse.insurance.detail.category [ CodeableConcept ]; # 0..1 Type of service
      fhir:EligibilityResponse.insurance.detail.service [ CodeableConcept ]; # 0..1 Billing Code
      fhir:EligibilityResponse.insurance.detail.modifier [ CodeableConcept ], ... ; # 0..* Service/Product billing modifiers
      fhir:EligibilityResponse.insurance.detail.provider [ Reference(Practitioner|PractitionerRole) ]; # 0..1 Performing practitioner
      fhir:EligibilityResponse.insurance.detail.excluded [ boolean ]; # 0..1 Excluded from the plan
      fhir:EligibilityResponse.insurance.detail.name [ string ]; # 0..1 Short name for the benefit
      fhir:EligibilityResponse.insurance.detail.description [ string ]; # 0..1 Description of the benefit or services covered
      fhir:EligibilityResponse.insurance.detail.network [ CodeableConcept ]; # 0..1 In or out of network
      fhir:EligibilityResponse.insurance.detail.unit [ CodeableConcept ]; # 0..1 Individual or family
      fhir:EligibilityResponse.insurance.detail.term [ CodeableConcept ]; # 0..1 Annual or lifetime
      fhir:EligibilityResponse.insurance.detail.benefit [ # 0..* Benefit Summary
        fhir:EligibilityResponse.insurance.detail.benefit.type [ CodeableConcept ]; # 1..1 Deductable, visits, benefit amount
        # EligibilityResponse.insurance.detail.benefit.allowed[x] : 0..1 Benefits allowed. One of these 3
          fhir:EligibilityResponse.insurance.detail.benefit.allowedUnsignedInt [ unsignedInt ]
          fhir:EligibilityResponse.insurance.detail.benefit.allowedString [ string ]
          fhir:EligibilityResponse.insurance.detail.benefit.allowedMoney [ Money ]
        # EligibilityResponse.insurance.detail.benefit.used[x] : 0..1 Benefits used. One of these 2
          fhir:EligibilityResponse.insurance.detail.benefit.usedUnsignedInt [ unsignedInt ]
          fhir:EligibilityResponse.insurance.detail.benefit.usedMoney [ Money ]
      ], ...;
      fhir:EligibilityResponse.insurance.detail.authorizationRequired [ boolean ]; # 0..1 Authorization required flag
      fhir:EligibilityResponse.insurance.detail.authorizationSupporting [ CodeableConcept ], ... ; # 0..* Codes or text of materials to be submitted
      fhir:EligibilityResponse.insurance.detail.authorizationUrl [ uri ]; # 0..1 Pre-authorization requirements
    ], ...;
  ], ...;
  fhir:EligibilityResponse.preAuthRef [ string ]; # 0..1 Pre-Authorization/Determination Reference
  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.use
  • Added Element
EligibilityResponse.patient
  • Added Element
EligibilityResponse.serviced[x]
  • Added Element
EligibilityResponse.requestProvider
  • Type changed from Reference(Practitioner) to Reference(Practitioner|PractitionerRole|Organization)
EligibilityResponse.outcome
  • Type changed from CodeableConcept to code
EligibilityResponse.insurance.inforce
  • Added Element
EligibilityResponse.insurance.detail
  • Added Element
EligibilityResponse.insurance.detail.category
  • Added Element
EligibilityResponse.insurance.detail.service
  • Added Element
EligibilityResponse.insurance.detail.modifier
  • Added Element
EligibilityResponse.insurance.detail.provider
  • Added Element
EligibilityResponse.insurance.detail.excluded
  • Added Element
EligibilityResponse.insurance.detail.name
  • Added Element
EligibilityResponse.insurance.detail.description
  • Added Element
EligibilityResponse.insurance.detail.network
  • Added Element
EligibilityResponse.insurance.detail.unit
  • Added Element
EligibilityResponse.insurance.detail.term
  • Added Element
EligibilityResponse.insurance.detail.benefit
  • Added Element
EligibilityResponse.insurance.detail.benefit.type
  • Added Element
EligibilityResponse.insurance.detail.benefit.allowed[x]
  • Added Element
EligibilityResponse.insurance.detail.benefit.used[x]
  • Added Element
EligibilityResponse.insurance.detail.authorizationRequired
  • Added Element
EligibilityResponse.insurance.detail.authorizationSupporting
  • Added Element
EligibilityResponse.insurance.detail.authorizationUrl
  • Added Element
EligibilityResponse.preAuthRef
  • Added Element
EligibilityResponse.requestOrganization
  • deleted
EligibilityResponse.inforce
  • deleted
EligibilityResponse.insurance.benefitBalance
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON.

 

Alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions & the dependency analysis

PathDefinitionTypeReference
EligibilityResponse.status A code specifying the state of the resource instance.RequiredFinancial Resource Status Codes
EligibilityResponse.use A code specifying the types of information being requested.RequiredEligibilityResponseUse
EligibilityResponse.outcome The outcome of the processing.RequiredRemittanceOutcome
EligibilityResponse.insurance.detail.category Benefit categories such as: oral, medical, vision etc.ExampleBenefit Category Codes
EligibilityResponse.insurance.detail.service Allowable service and product codesExampleUSCLS Codes
EligibilityResponse.insurance.detail.modifier Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen.ExampleModifier type Codes
EligibilityResponse.insurance.detail.network Code to classify in or out of network servicesExampleNetwork Type Codes
EligibilityResponse.insurance.detail.unit Unit covered/serviced - individual or familyExampleUnit Type Codes
EligibilityResponse.insurance.detail.term Coverage unit - annual, lifetimeExampleBenefit Term Codes
EligibilityResponse.insurance.detail.benefit.type Deductable, visits, co-pay, etc.ExampleBenefit Type Codes
EligibilityResponse.form The forms codes.ExampleForm Codes
EligibilityResponse.error.code The error codes for adjudication processing.ExampleAdjudication Error Codes

  • Rule elr-1: On EligibilityResponse.insurance.detail: SHALL contain a category or a service but not both. (expression on EligibilityResponse.insurance.detail: category.exists() xor service.exists())
  • Rule elr-2: On EligibilityResponse.insurance.detail: SHALL contain a service for modifier to be present. (expression on EligibilityResponse.insurance.detail: modifier.exists() and service.exists())

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionExpressionIn Common
createddateThe creation dateEligibilityResponse.created
dispositionstringThe contents of the disposition messageEligibilityResponse.disposition
identifiertokenThe business identifierEligibilityResponse.identifier
insurerreferenceThe organization which generated this resourceEligibilityResponse.insurer
(Organization)
outcometokenThe processing outcomeEligibilityResponse.outcome
patientreferenceThe reference to the patientEligibilityResponse.patient
(Patient)
requestreferenceThe EligibilityRequest referenceEligibilityResponse.request
(EligibilityRequest)
request-providerreferenceThe EligibilityRequest providerEligibilityResponse.requestProvider
(Practitioner, Organization, PractitionerRole)
statustokenThe EligibilityRequest statusEligibilityResponse.status