This page is part of the FHIR Specification (v5.0.0: R5 - STU). This is the current published version. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4

8.34 Resource InsurancePlan - Content

Patient Administration icon

Work Group

Maturity Level: 0

Trial Use

Security Category: Business

Compartments: No defined compartments

Details of a Health Insurance product/plan provided by an organization.

8.34.1 Scope and Usage

A product is a discrete package of health insurance coverage benefits that are offered under a particular network type. A given payer’s products typically differ by network type and/or coverage benefits. A plan pairs the health insurance coverage benefits under a product with the particular cost sharing structure offered to a consumer. A given product may comprise multiple plans.

InsurancePlan describes a health insurance offering comprised of a list of covered benefits (i.e. the product), costs associated with those benefits (i.e. the plan), and additional information about the offering, such as who it is owned and administered by, a coverage area, contact information, etc.

8.34.2 Boundaries and Relationships

TBD.

8.34.3 References to this Resource

Resource References: Coverage and UsageContext

Structure

Name	Flags	Card.	Type	Description & Constraints
InsurancePlan	TU		DomainResource	Details of a Health Insurance product/plan provided by an organization + Rule: The organization SHALL at least have a name or an identifier, and possibly more than one Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
identifier	Σ C	0..*	Identifier	Business Identifier for Product
status	?!Σ	0..1	code	draft \| active \| retired \| unknown Binding: PublicationStatus (Required)
type	Σ	0..*	CodeableConcept	Kind of product Binding: Insurance Plan Type (Example)
name	Σ C	0..1	string	Official name
alias		0..*	string	Alternate names
period		0..1	Period	When the product is available
ownedBy	Σ	0..1	Reference(Organization)	Product issuer
administeredBy	Σ	0..1	Reference(Organization)	Product administrator
coverageArea	Σ	0..*	Reference(Location)	Where product applies
contact		0..*	ExtendedContactDetail	Official contact details relevant to the health insurance plan/product
endpoint		0..*	Reference(Endpoint)	Technical endpoint
network		0..*	Reference(Organization)	What networks are Included
coverage		0..*	BackboneElement	Coverage details
type		1..1	CodeableConcept	Type of coverage
network		0..*	Reference(Organization)	What networks provide coverage
benefit		1..*	BackboneElement	List of benefits
type		1..1	CodeableConcept	Type of benefit
requirement		0..1	string	Referral requirements
limit		0..*	BackboneElement	Benefit limits
value		0..1	Quantity	Maximum value allowed
code		0..1	CodeableConcept	Benefit limit details
plan		0..*	BackboneElement	Plan details
identifier	Σ	0..*	Identifier	Business Identifier for Product
type		0..1	CodeableConcept	Type of plan
coverageArea	Σ	0..*	Reference(Location)	Where product applies
network		0..*	Reference(Organization)	What networks provide coverage
generalCost		0..*	BackboneElement	Overall costs
type		0..1	CodeableConcept	Type of cost
groupSize		0..1	positiveInt	Number of enrollees
cost		0..1	Money	Cost value
comment		0..1	string	Additional cost information
specificCost		0..*	BackboneElement	Specific costs
category		1..1	CodeableConcept	General category of benefit
benefit		0..*	BackboneElement	Benefits list
type		1..1	CodeableConcept	Type of specific benefit
cost		0..*	BackboneElement	List of the costs
type		1..1	CodeableConcept	Type of cost
applicability		0..1	CodeableConcept	in-network \| out-of-network \| other Binding: Benefit Cost Applicability (Required)
qualifiers		0..*	CodeableConcept	Additional information about the cost
value		0..1	Quantity	The actual cost value
Documentation for this format

See the Extensions for this resource

UML Diagram (Legend)

XML Template

<InsurancePlan xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- I 0..* Identifier Business Identifier for Product --></identifier>
 <status value="[code]"/><!-- 0..1 draft | active | retired | unknown -->
 <type><!-- 0..* CodeableConcept Kind of product --></type>
 <name value="[string]"/><!-- I 0..1 Official name -->
 <alias value="[string]"/><!-- 0..* Alternate names -->
 <period><!-- 0..1 Period When the product is available --></period>
 <ownedBy><!-- 0..1 Reference(Organization) Product issuer --></ownedBy>
 <administeredBy><!-- 0..1 Reference(Organization) Product administrator --></administeredBy>
 <coverageArea><!-- 0..* Reference(Location) Where product applies --></coverageArea>
 <contact><!-- 0..* ExtendedContactDetail Official contact details relevant to the health insurance plan/product --></contact>
 <endpoint><!-- 0..* Reference(Endpoint) Technical endpoint --></endpoint>
 <network><!-- 0..* Reference(Organization) What networks are Included --></network>
 <coverage>  <!-- 0..* Coverage details -->
  <type><!-- 1..1 CodeableConcept Type of coverage --></type>
  <network><!-- 0..* Reference(Organization) What networks provide coverage --></network>
  <benefit>  <!-- 1..* List of benefits -->
   <type><!-- 1..1 CodeableConcept Type of benefit --></type>
   <requirement value="[string]"/><!-- 0..1 Referral requirements -->
   <limit>  <!-- 0..* Benefit limits -->
    <value><!-- 0..1 Quantity Maximum value allowed --></value>
    <code><!-- 0..1 CodeableConcept Benefit limit details --></code>
   </limit>
  </benefit>
 </coverage>
 <plan>  <!-- 0..* Plan details -->
  <identifier><!-- 0..* Identifier Business Identifier for Product --></identifier>
  <type><!-- 0..1 CodeableConcept Type of plan --></type>
  <coverageArea><!-- 0..* Reference(Location) Where product applies --></coverageArea>
  <network><!-- 0..* Reference(Organization) What networks provide coverage --></network>
  <generalCost>  <!-- 0..* Overall costs -->
   <type><!-- 0..1 CodeableConcept Type of cost --></type>
   <groupSize value="[positiveInt]"/><!-- 0..1 Number of enrollees -->
   <cost><!-- 0..1 Money Cost value --></cost>
   <comment value="[string]"/><!-- 0..1 Additional cost information -->
  </generalCost>
  <specificCost>  <!-- 0..* Specific costs -->
   <category><!-- 1..1 CodeableConcept General category of benefit --></category>
   <benefit>  <!-- 0..* Benefits list -->
    <type><!-- 1..1 CodeableConcept Type of specific benefit --></type>
    <cost>  <!-- 0..* List of the costs -->
     <type><!-- 1..1 CodeableConcept Type of cost --></type>
     <applicability><!-- 0..1 CodeableConcept in-network | out-of-network | other --></applicability>
     <qualifiers><!-- 0..* CodeableConcept Additional information about the cost --></qualifiers>
     <value><!-- 0..1 Quantity The actual cost value --></value>
    </cost>
   </benefit>
  </specificCost>
 </plan>
</InsurancePlan>

JSON Template

{
  "resourceType" : "InsurancePlan",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // I Business Identifier for Product
  "status" : "<code>", // draft | active | retired | unknown
  "type" : [{ CodeableConcept }], // Kind of product
  "name" : "<string>", // I Official name
  "alias" : ["<string>"], // Alternate names
  "period" : { Period }, // When the product is available
  "ownedBy" : { Reference(Organization) }, // Product issuer
  "administeredBy" : { Reference(Organization) }, // Product administrator
  "coverageArea" : [{ Reference(Location) }], // Where product applies
  "contact" : [{ ExtendedContactDetail }], // Official contact details relevant to the health insurance plan/product
  "endpoint" : [{ Reference(Endpoint) }], // Technical endpoint
  "network" : [{ Reference(Organization) }], // What networks are Included
  "coverage" : [{ // Coverage details
    "type" : { CodeableConcept }, // R!  Type of coverage
    "network" : [{ Reference(Organization) }], // What networks provide coverage
    "benefit" : [{ // R!  List of benefits
      "type" : { CodeableConcept }, // R!  Type of benefit
      "requirement" : "<string>", // Referral requirements
      "limit" : [{ // Benefit limits
        "value" : { Quantity }, // Maximum value allowed
        "code" : { CodeableConcept } // Benefit limit details
      }]
    }]
  }],
  "plan" : [{ // Plan details
    "identifier" : [{ Identifier }], // Business Identifier for Product
    "type" : { CodeableConcept }, // Type of plan
    "coverageArea" : [{ Reference(Location) }], // Where product applies
    "network" : [{ Reference(Organization) }], // What networks provide coverage
    "generalCost" : [{ // Overall costs
      "type" : { CodeableConcept }, // Type of cost
      "groupSize" : "<positiveInt>", // Number of enrollees
      "cost" : { Money }, // Cost value
      "comment" : "<string>" // Additional cost information
    }],
    "specificCost" : [{ // Specific costs
      "category" : { CodeableConcept }, // R!  General category of benefit
      "benefit" : [{ // Benefits list
        "type" : { CodeableConcept }, // R!  Type of specific benefit
        "cost" : [{ // List of the costs
          "type" : { CodeableConcept }, // R!  Type of cost
          "applicability" : { CodeableConcept }, // in-network | out-of-network | other
          "qualifiers" : [{ CodeableConcept }], // Additional information about the cost
          "value" : { Quantity } // The actual cost value
        }]
      }]
    }]
  }]
}

Turtle Template

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


[ a fhir:InsurancePlan;
  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:identifier  ( [ Identifier ] ... ) ; # 0..* I Business Identifier for Product
  fhir:status [ code ] ; # 0..1 draft | active | retired | unknown
  fhir:type  ( [ CodeableConcept ] ... ) ; # 0..* Kind of product
  fhir:name [ string ] ; # 0..1 I Official name
  fhir:alias  ( [ string ] ... ) ; # 0..* Alternate names
  fhir:period [ Period ] ; # 0..1 When the product is available
  fhir:ownedBy [ Reference(Organization) ] ; # 0..1 Product issuer
  fhir:administeredBy [ Reference(Organization) ] ; # 0..1 Product administrator
  fhir:coverageArea  ( [ Reference(Location) ] ... ) ; # 0..* Where product applies
  fhir:contact  ( [ ExtendedContactDetail ] ... ) ; # 0..* Official contact details relevant to the health insurance plan/product
  fhir:endpoint  ( [ Reference(Endpoint) ] ... ) ; # 0..* Technical endpoint
  fhir:network  ( [ Reference(Organization) ] ... ) ; # 0..* What networks are Included
  fhir:coverage ( [ # 0..* Coverage details
    fhir:type [ CodeableConcept ] ; # 1..1 Type of coverage
    fhir:network  ( [ Reference(Organization) ] ... ) ; # 0..* What networks provide coverage
    fhir:benefit ( [ # 1..* List of benefits
      fhir:type [ CodeableConcept ] ; # 1..1 Type of benefit
      fhir:requirement [ string ] ; # 0..1 Referral requirements
      fhir:limit ( [ # 0..* Benefit limits
        fhir:value [ Quantity ] ; # 0..1 Maximum value allowed
        fhir:code [ CodeableConcept ] ; # 0..1 Benefit limit details
      ] ... ) ;
    ] ... ) ;
  ] ... ) ;
  fhir:plan ( [ # 0..* Plan details
    fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Business Identifier for Product
    fhir:type [ CodeableConcept ] ; # 0..1 Type of plan
    fhir:coverageArea  ( [ Reference(Location) ] ... ) ; # 0..* Where product applies
    fhir:network  ( [ Reference(Organization) ] ... ) ; # 0..* What networks provide coverage
    fhir:generalCost ( [ # 0..* Overall costs
      fhir:type [ CodeableConcept ] ; # 0..1 Type of cost
      fhir:groupSize [ positiveInt ] ; # 0..1 Number of enrollees
      fhir:cost [ Money ] ; # 0..1 Cost value
      fhir:comment [ string ] ; # 0..1 Additional cost information
    ] ... ) ;
    fhir:specificCost ( [ # 0..* Specific costs
      fhir:category [ CodeableConcept ] ; # 1..1 General category of benefit
      fhir:benefit ( [ # 0..* Benefits list
        fhir:type [ CodeableConcept ] ; # 1..1 Type of specific benefit
        fhir:cost ( [ # 0..* List of the costs
          fhir:type [ CodeableConcept ] ; # 1..1 Type of cost
          fhir:applicability [ CodeableConcept ] ; # 0..1 in-network | out-of-network | other
          fhir:qualifiers  ( [ CodeableConcept ] ... ) ; # 0..* Additional information about the cost
          fhir:value [ Quantity ] ; # 0..1 The actual cost value
        ] ... ) ;
      ] ... ) ;
    ] ... ) ;
  ] ... ) ;
]

Changes from both R4 and R4B

InsurancePlan

InsurancePlan.contact

Type changed from BackboneElement to ExtendedContactDetail

InsurancePlan.contact.purpose

Deleted (-> InsurancePlan.contact.purpose)

InsurancePlan.contact.name

Deleted (-> InsurancePlan.contact.name)

InsurancePlan.contact.telecom

Deleted (-> InsurancePlan.contact.telecom)

InsurancePlan.contact.address

Deleted (-> InsurancePlan.contact.address)

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

Structure

Name	Flags	Card.	Type	Description & Constraints
InsurancePlan	TU		DomainResource	Details of a Health Insurance product/plan provided by an organization + Rule: The organization SHALL at least have a name or an identifier, and possibly more than one Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
identifier	Σ C	0..*	Identifier	Business Identifier for Product
status	?!Σ	0..1	code	draft \| active \| retired \| unknown Binding: PublicationStatus (Required)
type	Σ	0..*	CodeableConcept	Kind of product Binding: Insurance Plan Type (Example)
name	Σ C	0..1	string	Official name
alias		0..*	string	Alternate names
period		0..1	Period	When the product is available
ownedBy	Σ	0..1	Reference(Organization)	Product issuer
administeredBy	Σ	0..1	Reference(Organization)	Product administrator
coverageArea	Σ	0..*	Reference(Location)	Where product applies
contact		0..*	ExtendedContactDetail	Official contact details relevant to the health insurance plan/product
endpoint		0..*	Reference(Endpoint)	Technical endpoint
network		0..*	Reference(Organization)	What networks are Included
coverage		0..*	BackboneElement	Coverage details
type		1..1	CodeableConcept	Type of coverage
network		0..*	Reference(Organization)	What networks provide coverage
benefit		1..*	BackboneElement	List of benefits
type		1..1	CodeableConcept	Type of benefit
requirement		0..1	string	Referral requirements
limit		0..*	BackboneElement	Benefit limits
value		0..1	Quantity	Maximum value allowed
code		0..1	CodeableConcept	Benefit limit details
plan		0..*	BackboneElement	Plan details
identifier	Σ	0..*	Identifier	Business Identifier for Product
type		0..1	CodeableConcept	Type of plan
coverageArea	Σ	0..*	Reference(Location)	Where product applies
network		0..*	Reference(Organization)	What networks provide coverage
generalCost		0..*	BackboneElement	Overall costs
type		0..1	CodeableConcept	Type of cost
groupSize		0..1	positiveInt	Number of enrollees
cost		0..1	Money	Cost value
comment		0..1	string	Additional cost information
specificCost		0..*	BackboneElement	Specific costs
category		1..1	CodeableConcept	General category of benefit
benefit		0..*	BackboneElement	Benefits list
type		1..1	CodeableConcept	Type of specific benefit
cost		0..*	BackboneElement	List of the costs
type		1..1	CodeableConcept	Type of cost
applicability		0..1	CodeableConcept	in-network \| out-of-network \| other Binding: Benefit Cost Applicability (Required)
qualifiers		0..*	CodeableConcept	Additional information about the cost
value		0..1	Quantity	The actual cost value
Documentation for this format

See the Extensions for this resource

UML Diagram (Legend)

XML Template

<InsurancePlan xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- I 0..* Identifier Business Identifier for Product --></identifier>
 <status value="[code]"/><!-- 0..1 draft | active | retired | unknown -->
 <type><!-- 0..* CodeableConcept Kind of product --></type>
 <name value="[string]"/><!-- I 0..1 Official name -->
 <alias value="[string]"/><!-- 0..* Alternate names -->
 <period><!-- 0..1 Period When the product is available --></period>
 <ownedBy><!-- 0..1 Reference(Organization) Product issuer --></ownedBy>
 <administeredBy><!-- 0..1 Reference(Organization) Product administrator --></administeredBy>
 <coverageArea><!-- 0..* Reference(Location) Where product applies --></coverageArea>
 <contact><!-- 0..* ExtendedContactDetail Official contact details relevant to the health insurance plan/product --></contact>
 <endpoint><!-- 0..* Reference(Endpoint) Technical endpoint --></endpoint>
 <network><!-- 0..* Reference(Organization) What networks are Included --></network>
 <coverage>  <!-- 0..* Coverage details -->
  <type><!-- 1..1 CodeableConcept Type of coverage --></type>
  <network><!-- 0..* Reference(Organization) What networks provide coverage --></network>
  <benefit>  <!-- 1..* List of benefits -->
   <type><!-- 1..1 CodeableConcept Type of benefit --></type>
   <requirement value="[string]"/><!-- 0..1 Referral requirements -->
   <limit>  <!-- 0..* Benefit limits -->
    <value><!-- 0..1 Quantity Maximum value allowed --></value>
    <code><!-- 0..1 CodeableConcept Benefit limit details --></code>
   </limit>
  </benefit>
 </coverage>
 <plan>  <!-- 0..* Plan details -->
  <identifier><!-- 0..* Identifier Business Identifier for Product --></identifier>
  <type><!-- 0..1 CodeableConcept Type of plan --></type>
  <coverageArea><!-- 0..* Reference(Location) Where product applies --></coverageArea>
  <network><!-- 0..* Reference(Organization) What networks provide coverage --></network>
  <generalCost>  <!-- 0..* Overall costs -->
   <type><!-- 0..1 CodeableConcept Type of cost --></type>
   <groupSize value="[positiveInt]"/><!-- 0..1 Number of enrollees -->
   <cost><!-- 0..1 Money Cost value --></cost>
   <comment value="[string]"/><!-- 0..1 Additional cost information -->
  </generalCost>
  <specificCost>  <!-- 0..* Specific costs -->
   <category><!-- 1..1 CodeableConcept General category of benefit --></category>
   <benefit>  <!-- 0..* Benefits list -->
    <type><!-- 1..1 CodeableConcept Type of specific benefit --></type>
    <cost>  <!-- 0..* List of the costs -->
     <type><!-- 1..1 CodeableConcept Type of cost --></type>
     <applicability><!-- 0..1 CodeableConcept in-network | out-of-network | other --></applicability>
     <qualifiers><!-- 0..* CodeableConcept Additional information about the cost --></qualifiers>
     <value><!-- 0..1 Quantity The actual cost value --></value>
    </cost>
   </benefit>
  </specificCost>
 </plan>
</InsurancePlan>

JSON Template

{
  "resourceType" : "InsurancePlan",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // I Business Identifier for Product
  "status" : "<code>", // draft | active | retired | unknown
  "type" : [{ CodeableConcept }], // Kind of product
  "name" : "<string>", // I Official name
  "alias" : ["<string>"], // Alternate names
  "period" : { Period }, // When the product is available
  "ownedBy" : { Reference(Organization) }, // Product issuer
  "administeredBy" : { Reference(Organization) }, // Product administrator
  "coverageArea" : [{ Reference(Location) }], // Where product applies
  "contact" : [{ ExtendedContactDetail }], // Official contact details relevant to the health insurance plan/product
  "endpoint" : [{ Reference(Endpoint) }], // Technical endpoint
  "network" : [{ Reference(Organization) }], // What networks are Included
  "coverage" : [{ // Coverage details
    "type" : { CodeableConcept }, // R!  Type of coverage
    "network" : [{ Reference(Organization) }], // What networks provide coverage
    "benefit" : [{ // R!  List of benefits
      "type" : { CodeableConcept }, // R!  Type of benefit
      "requirement" : "<string>", // Referral requirements
      "limit" : [{ // Benefit limits
        "value" : { Quantity }, // Maximum value allowed
        "code" : { CodeableConcept } // Benefit limit details
      }]
    }]
  }],
  "plan" : [{ // Plan details
    "identifier" : [{ Identifier }], // Business Identifier for Product
    "type" : { CodeableConcept }, // Type of plan
    "coverageArea" : [{ Reference(Location) }], // Where product applies
    "network" : [{ Reference(Organization) }], // What networks provide coverage
    "generalCost" : [{ // Overall costs
      "type" : { CodeableConcept }, // Type of cost
      "groupSize" : "<positiveInt>", // Number of enrollees
      "cost" : { Money }, // Cost value
      "comment" : "<string>" // Additional cost information
    }],
    "specificCost" : [{ // Specific costs
      "category" : { CodeableConcept }, // R!  General category of benefit
      "benefit" : [{ // Benefits list
        "type" : { CodeableConcept }, // R!  Type of specific benefit
        "cost" : [{ // List of the costs
          "type" : { CodeableConcept }, // R!  Type of cost
          "applicability" : { CodeableConcept }, // in-network | out-of-network | other
          "qualifiers" : [{ CodeableConcept }], // Additional information about the cost
          "value" : { Quantity } // The actual cost value
        }]
      }]
    }]
  }]
}

Turtle Template

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


[ a fhir:InsurancePlan;
  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:identifier  ( [ Identifier ] ... ) ; # 0..* I Business Identifier for Product
  fhir:status [ code ] ; # 0..1 draft | active | retired | unknown
  fhir:type  ( [ CodeableConcept ] ... ) ; # 0..* Kind of product
  fhir:name [ string ] ; # 0..1 I Official name
  fhir:alias  ( [ string ] ... ) ; # 0..* Alternate names
  fhir:period [ Period ] ; # 0..1 When the product is available
  fhir:ownedBy [ Reference(Organization) ] ; # 0..1 Product issuer
  fhir:administeredBy [ Reference(Organization) ] ; # 0..1 Product administrator
  fhir:coverageArea  ( [ Reference(Location) ] ... ) ; # 0..* Where product applies
  fhir:contact  ( [ ExtendedContactDetail ] ... ) ; # 0..* Official contact details relevant to the health insurance plan/product
  fhir:endpoint  ( [ Reference(Endpoint) ] ... ) ; # 0..* Technical endpoint
  fhir:network  ( [ Reference(Organization) ] ... ) ; # 0..* What networks are Included
  fhir:coverage ( [ # 0..* Coverage details
    fhir:type [ CodeableConcept ] ; # 1..1 Type of coverage
    fhir:network  ( [ Reference(Organization) ] ... ) ; # 0..* What networks provide coverage
    fhir:benefit ( [ # 1..* List of benefits
      fhir:type [ CodeableConcept ] ; # 1..1 Type of benefit
      fhir:requirement [ string ] ; # 0..1 Referral requirements
      fhir:limit ( [ # 0..* Benefit limits
        fhir:value [ Quantity ] ; # 0..1 Maximum value allowed
        fhir:code [ CodeableConcept ] ; # 0..1 Benefit limit details
      ] ... ) ;
    ] ... ) ;
  ] ... ) ;
  fhir:plan ( [ # 0..* Plan details
    fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Business Identifier for Product
    fhir:type [ CodeableConcept ] ; # 0..1 Type of plan
    fhir:coverageArea  ( [ Reference(Location) ] ... ) ; # 0..* Where product applies
    fhir:network  ( [ Reference(Organization) ] ... ) ; # 0..* What networks provide coverage
    fhir:generalCost ( [ # 0..* Overall costs
      fhir:type [ CodeableConcept ] ; # 0..1 Type of cost
      fhir:groupSize [ positiveInt ] ; # 0..1 Number of enrollees
      fhir:cost [ Money ] ; # 0..1 Cost value
      fhir:comment [ string ] ; # 0..1 Additional cost information
    ] ... ) ;
    fhir:specificCost ( [ # 0..* Specific costs
      fhir:category [ CodeableConcept ] ; # 1..1 General category of benefit
      fhir:benefit ( [ # 0..* Benefits list
        fhir:type [ CodeableConcept ] ; # 1..1 Type of specific benefit
        fhir:cost ( [ # 0..* List of the costs
          fhir:type [ CodeableConcept ] ; # 1..1 Type of cost
          fhir:applicability [ CodeableConcept ] ; # 0..1 in-network | out-of-network | other
          fhir:qualifiers  ( [ CodeableConcept ] ... ) ; # 0..* Additional information about the cost
          fhir:value [ Quantity ] ; # 0..1 The actual cost value
        ] ... ) ;
      ] ... ) ;
    ] ... ) ;
  ] ... ) ;
]

Changes from both R4 and R4B

InsurancePlan

InsurancePlan.contact

Type changed from BackboneElement to ExtendedContactDetail

InsurancePlan.contact.purpose

Deleted (-> InsurancePlan.contact.purpose)

InsurancePlan.contact.name

Deleted (-> InsurancePlan.contact.name)

InsurancePlan.contact.telecom

Deleted (-> InsurancePlan.contact.telecom)

InsurancePlan.contact.address

Deleted (-> InsurancePlan.contact.address)

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

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

8.34.4.1 Terminology Bindings

Path	ValueSet	Type	Documentation
InsurancePlan.status	PublicationStatus	Required	The lifecycle status of an artifact.
InsurancePlan.type	InsurancePlanType	Example	This example value set defines a set of codes that can be used to indicate a type of insurance plan.
InsurancePlan.plan.specificCost.benefit.cost.applicability	BenefitCostApplicability	Required	Whether the cost applies to in-network or out-of-network providers.

Path

ValueSet

Type

Documentation

InsurancePlan.status

PublicationStatus

Required

The lifecycle status of an artifact.

InsurancePlan.type

InsurancePlanType

Example

This example value set defines a set of codes that can be used to indicate a type of insurance plan.

InsurancePlan.plan.specificCost.benefit.cost.applicability

BenefitCostApplicability

Required

Whether the cost applies to in-network or out-of-network providers.

8.34.4.2 Constraints

UniqueKey

Level

Location

Description

Expression

ipn-1

Rule

(base)

The organization SHALL at least have a name or an identifier, and possibly more than one

(identifier.count() + name.count()) > 0

8.34.5 Notes:

8.34.6 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to 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
address	string	A server defined search that may match any of the string fields in the Address, including line, city, district, state, country, postalCode, and/or text	InsurancePlan.contact.address
address-city	string	A city specified in an address	InsurancePlan.contact.address.city
address-country	string	A country specified in an address	InsurancePlan.contact.address.country
address-postalcode	string	A postal code specified in an address	InsurancePlan.contact.address.postalCode
address-state	string	A state specified in an address	InsurancePlan.contact.address.state
address-use	token	A use code specified in an address	InsurancePlan.contact.address.use
administered-by	reference	Product administrator	InsurancePlan.administeredBy (Organization)
endpoint	reference	Technical endpoint	InsurancePlan.endpoint (Endpoint)
identifier	token	Any identifier for the organization (not the accreditation issuer's identifier)	InsurancePlan.identifier
name	string	A portion of the organization's name or alias	InsurancePlan.name \| InsurancePlan.alias
owned-by	reference	An organization of which this organization forms a part	InsurancePlan.ownedBy (Organization)
phonetic	string	A portion of the organization's name using some kind of phonetic matching algorithm	InsurancePlan.name
status	token	Is the Organization record active	InsurancePlan.status
type	token	A code for the type of organization	InsurancePlan.type