InsurancePlan

Overview

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

The following fields are returned if valued:

Terminology Bindings

InsurancePlan.type

Search for InsurancePlans that meet supplied query parameters:

GET /InsurancePlan?:parameters

Authorization Types

Parameters

Name Required? Type Description
_id This or owned-by token The logical resource id associated with the resource.
owned-by Yes reference Organization associated with the InsurancePlan.

Headers

Accept: application/json+fhir
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/InsurancePlan?owned-by=589783

Response

Status: 200 OK
{
  "resourceType": "Bundle",
  "id": "e445217e-122b-4e89-9ae3-74e0ba1c24fb",
  "type": "searchset",
  "total": 4,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/InsurancePlan?owned-by=589783"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/InsurancePlan/2798233",
      "resource": {
        "resourceType": "InsurancePlan",
        "id": "2798233",
        "text": {
          "status": "generated",
          "div": "<div xmlns='http://www.w3.org/1999/xhtml\\"><p><b>Insurance Plan</b></p><p><b>Name</b>:Medicare Part A</p><p><b>Type</b>: Medical Service Plan</p><p><b>Owned By</b>:Organization/589783</p><p><b>Period Start Date</b>: Aug 14, 2015  2:32 P.M. UTC</p></div>"
        },
        "status": "active",
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/27137",
                "code": "4372138",
                "display": "Medical Service Plan",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/insurance-plan-type",
                "code": "medical",
                "display": "Medical",
                "userSelected": false
              }
            ],
            "text": "Medical Service Plan"
          }
        ],
        "name": "Medicare Part A",
        "period": {
          "start": "2015-08-14T14:32:01.000Z"
        },
        "ownedBy": {
          "reference": "Organization/589783"
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/InsurancePlan/3132244",
      "resource": {
        "resourceType": "InsurancePlan",
        "id": "3132244",
        "text": {
          "status": "generated",
          "div": "<div xmlns='http://www.w3.org/1999/xhtml\\"><p><b>Insurance Plan</b></p><p><b>Name</b>:Medicare Part A and B</p><p><b>Type</b>: Medical Service Plan</p><p><b>Owned By</b>:Organization/589783</p><p><b>Period Start Date</b>: Apr  3, 2018  8:37 P.M. UTC</p></div>"
        },
        "status": "active",
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/27137",
                "code": "4372138",
                "display": "Medical Service Plan",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/insurance-plan-type",
                "code": "medical",
                "display": "Medical",
                "userSelected": false
              }
            ],
            "text": "Medical Service Plan"
          }
        ],
        "name": "Medicare Part A and B",
        "period": {
          "start": "2018-04-03T20:37:54.000Z"
        },
        "ownedBy": {
          "reference": "Organization/589783"
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/InsurancePlan/3132243",
      "resource": {
        "resourceType": "InsurancePlan",
        "id": "3132243",
        "text": {
          "status": "generated",
          "div": "<div xmlns='http://www.w3.org/1999/xhtml\\"><p><b>Insurance Plan</b></p><p><b>Name</b>:Medicare Part B</p><p><b>Type</b>: Medical Service Plan</p><p><b>Owned By</b>:Organization/589783</p><p><b>Period Start Date</b>: Apr  3, 2018  8:36 P.M. UTC</p></div>"
        },
        "status": "active",
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/27137",
                "code": "4372138",
                "display": "Medical Service Plan",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/insurance-plan-type",
                "code": "medical",
                "display": "Medical",
                "userSelected": false
              }
            ],
            "text": "Medical Service Plan"
          }
        ],
        "name": "Medicare Part B",
        "period": {
          "start": "2018-04-03T20:36:27.000Z"
        },
        "ownedBy": {
          "reference": "Organization/589783"
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/InsurancePlan/3226346",
      "resource": {
        "resourceType": "InsurancePlan",
        "id": "3226346",
        "text": {
          "status": "generated",
          "div": "<div xmlns='http://www.w3.org/1999/xhtml\\"><p><b>Insurance Plan</b></p><p><b>Name</b>:Medicare Provider Liable</p><p><b>Type</b>: Medical Service Plan</p><p><b>Owned By</b>:Organization/589783</p><p><b>Period Start Date</b>: Apr 16, 2019  5:42 P.M. UTC</p></div>"
        },
        "status": "active",
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/27137",
                "code": "4372138",
                "display": "Medical Service Plan",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/insurance-plan-type",
                "code": "medical",
                "display": "Medical",
                "userSelected": false
              }
            ],
            "text": "Medical Service Plan"
          }
        ],
        "name": "Medicare Provider Liable",
        "period": {
          "start": "2019-04-16T17:42:34.000Z"
        },
        "ownedBy": {
          "reference": "Organization/589783"
        }
      }
    }
  ]
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Errors

The common errors and OperationOutcomes may be returned.

Retrieve by id

List an individual InsurancePlan by its id:

GET /InsurancePlan/:id

Authorization Types

Headers

Accept: application/fhir+json
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/InsurancePlan/2798233

Response

Status: 200 OK
{
  "resourceType": "InsurancePlan",
  "id": "589723",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\\"http://www.w3.org/1999/xhtml\\"><p><b>Insurance Plan</b></p><p><b>Name</b>:Miscellaneous Commercial Health Plan</p><p><b>Type</b>: Medical Service Plan</p><p><b>Owned By</b>:SELF PAY</p><p><b>Period Start Date</b>: Aug 26, 2003 12:00 A.M. UTC</p></div>"
  },
  "status": "active",
  "type": [
    {
      "coding": [
        {
          "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/27137",
          "code": "6681216",
          "display": "Medical Service Plan",
          "userSelected": true
        },
        {
          "system": "http://terminology.hl7.org/CodeSystem/insurance-plan-type",
          "code": "medical",
          "display": "Medical",
          "userSelected": false
        }
      ],
      "text": "Medical Service Plan"
    }
  ],
  "name": "Miscellaneous Commercial Health Plan",
  "period": {
    "start": "2003-08-26T00:00:00.000Z"
  },
  "ownedBy": {
    "reference": "Organization/589803",
    "display": "SELF PAY"
  }
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Errors

The common errors and OperationOutcomes may be returned.