> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metriport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# InsurancePlan

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

## Properties

| Name                | Required | Type                                                                    | Description                                            |
| ------------------- | -------- | ----------------------------------------------------------------------- | ------------------------------------------------------ |
| identifier          | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                | Business Identifier for Product                        |
| status              | No       | code                                                                    | draft / active / retired / unknown                     |
| type                | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]      | Kind of product                                        |
| name                | No       | string                                                                  | Official name                                          |
| alias               | No       | string\[]                                                               | Alternate names                                        |
| period              | No       | [Period](/medical-api/fhir/data-types/period)                           | When the product is available                          |
| ownedBy             | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>    | Plan issuer                                            |
| administeredBy      | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>    | Product administrator                                  |
| coverageArea        | No       | Reference\<[Location](/medical-api/fhir/resources/location)>\[]         | Where product applies                                  |
| contact             | No       | InsurancePlanContact                                                    | Contact for the product                                |
| - id                | No       | string                                                                  | Unique id for inter-element referencing                |
| - extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Additional content defined by implementations          |
| - modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Extensions that cannot be ignored even if unrecognized |
| - purpose           | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)         | The type of contact                                    |
| - name              | No       | [HumanName](/medical-api/fhir/data-types/humanname)                     | A name associated with the contact                     |
| - telecom           | No       | [ContactPoint](/medical-api/fhir/data-types/contactpoint)\[]            | Contact details (telephone, email, etc.) for a contact |
| - address           | No       | [Address](/medical-api/fhir/data-types/address)                         | Visiting or postal addresses for the contact           |
| endpoint            | No       | Reference\<[Endpoint](/medical-api/fhir/resources/endpoint)>\[]         | Technical endpoint                                     |
| network             | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>\[] | What networks are Included                             |
| coverage            | No       | InsurancePlanCoverage                                                   | Coverage details                                       |
| - id                | No       | string                                                                  | Unique id for inter-element referencing                |
| - extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Additional content defined by implementations          |
| - modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Extensions that cannot be ignored even if unrecognized |
| - type              | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)         | Type of coverage                                       |
| - network           | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>\[] | What networks provide coverage                         |
| - benefit           | Yes      | InsurancePlanCoverageBenefit                                            | List of benefits                                       |
| - id                | No       | string                                                                  | Unique id for inter-element referencing                |
| - extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Additional content defined by implementations          |
| - modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Extensions that cannot be ignored even if unrecognized |
| - type              | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)         | Type of benefit                                        |
| - requirement       | No       | string                                                                  | Referral requirements                                  |
| - limit             | No       | InsurancePlanCoverageBenefitLimit                                       | Benefit limits                                         |
| - id                | No       | string                                                                  | Unique id for inter-element referencing                |
| - extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Additional content defined by implementations          |
| - modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Extensions that cannot be ignored even if unrecognized |
| - value             | No       | [Quantity](/medical-api/fhir/data-types/quantity)                       | Maximum value allowed                                  |
| - code              | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)         | Benefit limit details                                  |
| plan                | No       | InsurancePlanPlan                                                       | Plan details                                           |
| - id                | No       | string                                                                  | Unique id for inter-element referencing                |
| - extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Additional content defined by implementations          |
| - modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Extensions that cannot be ignored even if unrecognized |
| - identifier        | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                | Business Identifier for Product                        |
| - type              | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)         | Type of plan                                           |
| - coverageArea      | No       | Reference\<[Location](/medical-api/fhir/resources/location)>\[]         | Where product applies                                  |
| - network           | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>\[] | What networks provide coverage                         |
| - generalCost       | No       | InsurancePlanPlanGeneralCost                                            | Overall costs                                          |
| - id                | No       | string                                                                  | Unique id for inter-element referencing                |
| - extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Additional content defined by implementations          |
| - modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Extensions that cannot be ignored even if unrecognized |
| - type              | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)         | Type of cost                                           |
| - groupSize         | No       | positiveInt                                                             | Number of enrollees                                    |
| - cost              | No       | [Money](/medical-api/fhir/data-types/money)                             | Cost value                                             |
| - comment           | No       | string                                                                  | Additional cost information                            |
| - specificCost      | No       | InsurancePlanPlanSpecificCost                                           | Specific costs                                         |
| - id                | No       | string                                                                  | Unique id for inter-element referencing                |
| - extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Additional content defined by implementations          |
| - modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Extensions that cannot be ignored even if unrecognized |
| - category          | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)         | General category of benefit                            |
| - benefit           | No       | InsurancePlanPlanSpecificCostBenefit                                    | Benefits list                                          |
| - id                | No       | string                                                                  | Unique id for inter-element referencing                |
| - extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Additional content defined by implementations          |
| - modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Extensions that cannot be ignored even if unrecognized |
| - type              | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)         | Type of specific benefit                               |
| - cost              | No       | InsurancePlanPlanSpecificCostBenefitCost                                | List of the costs                                      |
| - id                | No       | string                                                                  | Unique id for inter-element referencing                |
| - extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Additional content defined by implementations          |
| - modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                  | Extensions that cannot be ignored even if unrecognized |
| - type              | Yes      | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)         | Type of cost                                           |
| - applicability     | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)         | in-network / out-of-network / other                    |
| - qualifiers        | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]      | Additional information about the cost                  |
| - value             | No       | [Quantity](/medical-api/fhir/data-types/quantity)                       | The actual cost value                                  |

## Search Parameters

| Name               | Type      | Description                                                                                                                                             | Expression                               |
| ------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| 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             |
| endpoint           | reference | Technical endpoint                                                                                                                                      | InsurancePlan.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                                                                                                           |                                          |
| owned-by           | reference | An organization of which this organization forms a part                                                                                                 | InsurancePlan.ownedBy                    |
| 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                       |

## Inherited Properties

| Name              | Required | Type                                                   | Description                                            |
| ----------------- | -------- | ------------------------------------------------------ | ------------------------------------------------------ |
| id                | No       | string                                                 | Logical id of this artifact                            |
| meta              | No       | [Meta](/medical-api/fhir/data-types/meta)              | Metadata about the resource                            |
| implicitRules     | No       | uri                                                    | A set of rules under which this content was created    |
| language          | No       | code                                                   | Language of the resource content                       |
| text              | No       | [Narrative](/medical-api/fhir/data-types/narrative)    | Text summary of the resource, for human interpretation |
| contained         | No       | Resource\[]                                            | Contained, inline Resources                            |
| extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations          |
| modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored                      |

To view the FHIR specification for this resource, see [InsurancePlan](https://www.hl7.org/fhir/StructureDefinition/InsurancePlan).
