Get a list of coverages

get

/Coverage

Retrieves a list of patient-level or encounter-level coverages that meet supplied query parameters.

Note: Public Healthcare represents an insurance policy funded by a public health system such as a provincial or national health plan. If any public coverages exist, they are returned with an ID prefixed with PH or PHP and returned in the payload with the rest of the coverages (private coverages).

Authorization Types

This operation supports the following authorization types:

Request

Query Parameters
  • The logical resource ID of the clinical encounter. Required if the _id and patient parameters are not used.

    Example: -encounter=98028029

  • The logical resource ID. Required if the patient and -encounter parameters are not used.

    Example: _id=12724066-490016987-490016987

  • The Provenance resource entries to be returned as part of the bundle.
    • May be provided once with the Provenance:target value. Example: _revinclude=Provenance:target.
    • May be provided with the _id, patient, or -encounter parameters. Example: _id=13410103-490794713-490794713&_revinclude=Provenance:target.
    • When _revinclude is provided in a request to the closed endpoint, the OAuth2 token must include the scope corresponding with the authorization type, such as user/Provenance.read, patient/Provenance.read, or system/Provenance.read.
    Example: _revinclude=Provenance:target
  • The entity that caused the expenses. Required if the _id and -encounter parameters are not used.

    Example: patient=Patient/12345

Header Parameters
Back to Top

Response

Supported Media Types

Default Response

Example search for patient-level private coverage.

Example Request:
GET https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?patient=12724066
Example Response:
{
    'resourceType': 'Bundle',
    'id': 'a8876443-c615-4244-9044-047dea2d92dd',
    'type': 'searchset',
    'total': 1,
    'link': [
      {
        'relation': 'self',
        'url': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?patient=12724066'
      }
    ],
    'entry': [
      {
        'fullUrl': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage/12724066-490016987-490016987',
        'resource': {
          'resourceType': 'Coverage',
          'id': '12724066-490016987-490016987',
          'meta': {
            'versionId': '24-24',
            'lastUpdated': '2020-07-06T17:03:43.000Z'
          },
          'text': {
            'status': 'generated',
            'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Subscriber</b>: SMART, NANCY</p><p><b>Beneficiary</b>: SMART, NANCY</p><p><b>Coverage Start Date</b>: Aug 14, 2015  7:07 P.M. UTC</p><p><b>Payor</b>: SELF PAY</p><p><b>Class</b>: plan: Value: 2800235 Name: Self Pay</p></div>'
          },
          'identifier': [
            {
              'type': {
                'coding': [
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/v2-0203',
                    'code': 'MB'
                  }
                ]
              },
              'value': '123'
            },
            {
              'type': {
                'coding': [
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/v2-0203',
                    'code': 'MB'
                  }
                ]
              },
              'value': '123'
            }
          ],
          'status': 'active',
          'type': {
              'coding': [
                  {
                      'system': 'urn:oid:2.16.840.1.113883.3.221.5',
                      'code': '5',
                      'display': 'PRIVATE HEALTH INSURANCE',
                      'userSelected': false
                  }
              ],
              'text': 'Private Health Insurance'
          },
          'subscriber': {
            'reference': 'Patient/12724066',
            'display': 'SMART, NANCY'
          },
          'beneficiary': {
            'reference': 'Patient/12724066',
            'display': 'SMART, NANCY'
          },
          'relationship': {
            'coding': [
              {
                'system': 'http://terminology.hl7.org/CodeSystem/subscriber-relationship',
                'code': 'self',
                'display': 'Self',
                'userSelected': false
              }
            ],
            'text': 'Self'
          },
          'period': {
            'start': '2015-08-14T19:07:56.000Z'
          },
          'payor': [
            {
              'reference': 'Organization/589803',
              'display': 'SELF PAY'
            }
          ],
          'class': [
            {
              'type': {
                'coding': [
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/coverage-class',
                    'code': 'plan'
                  }
                ]
              },
              'value': '2800235',
              'name': 'Self Pay'
            }
          ]
        }
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.

x-encounter-level-private Response

Example search for encounter-level private coverage.

Example Request:
GET https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?-encounter=97954095
Example Response:
{
    'resourceType': 'Bundle',
    'id': 'd42baa44-1566-458c-8457-10fbfacfc3e5',
    'type': 'searchset',
    'total': 1,
    'link': [
      {
        'relation': 'self',
        'url': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?-encounter=97954095'
      }
    ],
    'entry': [
      {
        'fullUrl': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage/97954095-98320174',
        'resource': {
          'resourceType': 'Coverage',
          'id': '97954095-98320174',
          'meta': {
            'versionId': '0',
            'lastUpdated': '2020-07-27T21:01:55.000Z'
          },
          'text': {
            'status': 'extensions',
            'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Subscriber</b>: SMART, NANCY</p><p><b>Subscriber Id</b>: 12345</p><p><b>Encounter</b>: 97954095</p><p><b>Beneficiary</b>: SMART, NANCY</p><p><b>Dependent Number</b>: 12345</p><p><b>Coverage Start Date</b>: Feb  2, 2020  6:00 A.M. UTC</p><p><b>Coverage End Date</b>: Feb  3, 2021  5:59 A.M. UTC</p><p><b>Payor</b>: Aetna</p><p><b>Class</b>: plan: Value: 2830233 Name: Aetna</p></div>'
          },
          'extension': [
            {
              'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/coverage-encounter',
              'valueReference': {
                'reference': 'Encounter/97954095'
              }
            }
          ],
          'status': 'active',
          'type': {
              'coding': [
                  {
                      'system': 'urn:oid:2.16.840.1.113883.3.221.5',
                      'code': '5',
                      'display': 'PRIVATE HEALTH INSURANCE',
                      'userSelected': false
                  }
              ],
              'text': 'Private Health Insurance'
          },
          'subscriber': {
            'reference': 'Patient/12724066',
            'display': 'SMART, NANCY'
          },
          'subscriberId': '12345',
          'beneficiary': {
            'reference': 'Patient/12724066',
            'display': 'SMART, NANCY'
          },
          'dependent': '12345',
          'relationship': {
            'coding': [
              {
                'system': 'http://terminology.hl7.org/CodeSystem/subscriber-relationship',
                'code': 'self',
                'display': 'Self',
                'userSelected': false
              }
            ],
            'text': 'Self'
          },
          'period': {
            'start': '2020-02-02T06:00:00.000Z',
            'end': '2021-02-03T05:59:59.000Z'
          },
          'payor': [
            {
              'reference': 'Organization/3064032',
              'display': 'Aetna'
            }
          ],
          'class': [
            {
              'type': {
                'coding': [
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/coverage-class',
                    'code': 'plan'
                  }
                ]
              },
              'value': '2830233',
              'name': 'Aetna'
            }
          ]
        }
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.

x-encounter-level-public Response

Example search for encounter-level public coverage.

Example Request:
GET https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?-encounter=97701467
Example Response:
{
    'resourceType': 'Bundle',
    'id': '1714d1b5-cabf-4c4a-bb76-c1e2e4d76d64',
    'type': 'searchset',
    'total': 1,
    'link': [
      {
        'relation': 'self',
        'url': 'https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?-encounter=97701467'
      }
    ],
    'entry': [
      {
        'fullUrl': 'https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage/PH-98371617-97701467',
        'resource': {
          'resourceType': 'Coverage',
          'id': 'PH-98371617-97701467',
          'meta': {
            'versionId': '2-0',
            'lastUpdated': '2020-09-24T17:11:10.000Z'
          },
          'text': {
            'status': 'extensions',
            'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Encounter</b>: 97701467</p><p><b>Beneficiary</b>: TRAUMA SURGERY, TESTONE</p><p><b>Coverage Start Date</b>: Jul  1, 2022  5:00 A.M. UTC</p><p><b>Coverage End Date</b>: Jul  1, 2025  5:00 A.M. UTC</p><p><b>Payor</b>: Government</p><p><b>Class</b>:</p><dl><dt>Class</dt><dd><b>Value</b>: 2572499881</dd><dd><b>Name</b>: Charging Category</dd></dl><p><b>Type</b>: public healthcare</p></div>'
          },
          'extension': [
            {
              'valueReference': {
                'reference': 'Encounter/97701467'
              },
              'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/coverage-encounter'
            }
          ],
          'status': 'active',
          'type': {
            'coding': [
              {
                'system': 'http://terminology.hl7.org/CodeSystem/v3-ActCode',
                'code': 'PUBLICPOL',
                'display': 'public healthcare'
              }
            ],
            'text': 'public healthcare'
          },
          'beneficiary': {
            'reference': 'Patient/12462008',
            'display': 'TRAUMA SURGERY, TESTONE'
          },
          'period': {
            'start': '2022-07-01T05:00:00.000Z',
            'end': '2025-07-01T05:00:00.000Z'
          },
          'payor': [
            {
              'display': 'Government'
            }
          ],
          'class': [
            {
              'type': {
                'coding': [
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/coverage-class',
                    'code': 'class'
                  }
                ]
              },
              'value': '2572499881',
              'name': 'Charging Category'
            }
          ]
        }
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.

x-id-level-private Response

Example search for ID-level private coverage.

Example Request:
GET https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?_id=12724066-491651736-491651736
Example Response:
{
    'resourceType': 'Coverage',
    'id': '12724066-491651736-491651736',
    'meta': {
      'versionId': '4-4',
      'lastUpdated': '2024-01-10T19:33:27.000Z'
    },
    'text': {
      'status': 'generated',
      'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Subscriber</b>: SMART II, NANCY</p><p><b>Beneficiary</b>: SMART II, NANCY</p><p><b>Relationship</b>: Self</p><p><b>Coverage Start Date</b>: Jun  6, 2021 12:00 A.M. UTC</p><p><b>Payor</b>: MEDICARE</p><p><b>Class</b>:</p><dl><dt>Plan</dt><dd><b>Value</b>: 3132243</dd><dd><b>Name</b>: Medicare Part B</dd></dl></div>'
    },
    'identifier': [
      {
        'extension': [
          {
            'valueCode': 'unknown',
            'url': 'http://hl7.org/fhir/StructureDefinition/data-absent-reason'
          }
        ]
      }
    ],
    'status': 'active',
    'type': {
        'coding': [
            {
                'system': 'urn:oid:2.16.840.1.113883.3.221.5',
                'code': '5',
                'display': 'PRIVATE HEALTH INSURANCE',
                'userSelected': false
            }
        ],
        'text': 'Private Health Insurance'
    },
    'subscriber': {
      'reference': 'Patient/12724066',
      'display': 'SMART II, NANCY'
    },
    'beneficiary': {
      'reference': 'Patient/12724066',
      'display': 'SMART II, NANCY'
    },
    'relationship': {
      'coding': [
        {
          'system': 'http://terminology.hl7.org/CodeSystem/subscriber-relationship',
          'code': 'self',
          'display': 'Self',
          'userSelected': false
        }
      ],
      'text': 'Self'
    },
    'period': {
      'start': '2021-06-06T00:00:00.000Z'
    },
    'payor': [
      {
        'reference': 'Organization/589783',
        'display': 'MEDICARE'
      }
    ],
    'class': [
      {
        'type': {
          'coding': [
            {
              'system': 'http://terminology.hl7.org/CodeSystem/coverage-class',
              'code': 'plan'
            }
          ]
        },
        'value': '3132243',
        'name': 'Medicare Part B'
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.

x-patient-level-public Response

Example search for patient-level public coverage.

Example Request:
GET https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?patient=12724066
Example Response:
{
    'resourceType': 'Bundle',
    'id': '8ff4481d-ce55-4b3f-ac2c-4d4fd3cad4c0',
    'type': 'searchset',
    'total': 1,
    'link': [
      {
        'relation': 'self',
        'url': 'https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?patient=12724066'
      }
    ],
    'entry': [
      {
        'fullUrl': 'https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage/PHP-490218084-12724066',
        'resource': {
          'resourceType': 'Coverage',
          'id': 'PHP-490218084-12724066',
          'meta': {
            'versionId': '134-0',
            'lastUpdated': '2021-03-16T20:04:11.000Z'
          },
          'text': {
            'status': 'generated',
            'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Beneficiary</b>: SMART, NANCY</p><p><b>Coverage Start Date</b>: Mar 16, 2021  8:04 P.M. UTC</p><p><b>Payor</b>: Government</p><p><b>Class</b>:</p><dl><dt>Charging Category</dt><dd><b>Value</b>:2572940471</dd><dd><b>Name</b>: 10-OPC, Class II</dd></dl><p><b>Type</b>: public healthcare</p></div>'
          },
          'status': 'active',
          'type': {
            'coding': [
              {
                'system': 'http://terminology.hl7.org/CodeSystem/v3-ActCode',
                'code': 'PUBLICPOL',
                'display': 'public healthcare'
              }
            ],
            'text': 'public healthcare'
          },
          'beneficiary': {
            'reference': 'Patient/12462008',
            'display': 'TRAUMA SURGERY, TESTONE'
          },
          'period': {
            'start': '2021-03-16T20:04:11.000Z'
          },
          'payor': [
            {
              'display': 'Government'
            }
          ],
          'class': [
            {
              'type': {
                'text': 'Charging Category'
              },
              'value': '2572940471',
              'name': '10-OPC, Class II'
            }
          ]
        }
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.

x-search-encounter-with-_revinclude Response

Example search by -encounter using _revinclude.
Example Request:
GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?encounter=98497601&_revinclude=Provenance:target
Example Response:

  {
    "resourceType": "Bundle",
    "id": "5983892b-700d-425f-a416-f7409e300451",
    "type": "searchset",
    "total": 4,
    "link":
      [
        {
          "relation": "self",
          "url": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?-encounter=98497601&_revinclude=Provenance:target"
        }
      ],
    "entry":
      [
        {
          "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage/98497601-99038102",
          "resource":
            {
              "resourceType": "Coverage",
              "id": "98497601-99038102",
              "meta":
                {
                  "versionId": "0",
                  "lastUpdated": "2021-09-01T07:34:48.000Z"
                },
              "text":
                {
                  "status": "extensions",
                  "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Subscriber</b>: RCSHRORDAUTHA, PATA</p><p><b>Encounter</b>: 98497601</p><p><b>Beneficiary</b>: RCSHRORDAUTHA, PATA</p><p><b>Relationship</b>: self</p><p><b>Coverage Start Date</b>: Sep  1, 2021 12:00 A.M. CDT</p><p><b>Payor</b>: MEDICARE</p><p><b>Class</b>:</p><dl><dt>Plan</dt><dd><b>Value</b>: 2798233</dd><dd><b>Name</b>: MEDICARE PART A</dd></dl></div>"
                },
              "extension":
                [
                  {
                    "valueReference":
                      {
                        "reference": "Encounter/98497601"
                      },
                    "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/coverage-encounter"
                  }
                ],
              "identifier":
                [
                  {
                    "extension":
                      [
                        {
                          "valueCode": "unknown",
                          "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
                        }
                      ]
                  }
                ],
              "status": "active",
              "type":
                {
                  "coding":
                    [
                      {
                        "system": "urn:oid:2.16.840.1.113883.3.221.5",
                        "code": "1",
                        "display": "MEDICARE",
                        "userSelected": false
                      }
                    ],
                  "text": "Medicare"
                },
              "subscriber":
                {
                  "reference": "Patient/13554095",
                  "display": "RCSHRORDAUTHA, PATA"
                },
              "beneficiary":
                {
                  "reference": "Patient/13554095",
                  "display": "RCSHRORDAUTHA, PATA"
                },
              "relationship":
                {
                  "coding":
                    [
                      {
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "code": "SELF",
                        "display": "self",
                        "userSelected": false
                      },
                      {
                        "system": "http://terminology.hl7.org/CodeSystem/subscriber-relationship",
                        "code": "self",
                        "display": "Self",
                        "userSelected": false
                      }
                    ],
                  "text": "Self"
                },
              "period":
                {
                  "start": "2021-09-01T05:00:00.000Z"
                },
              "payor":
                [
                  {
                    "reference": "Organization/589783",
                    "display": "MEDICARE"
                  }
                ],
              "class":
                [
                  {
                    "type":
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/coverage-class",
                              "code": "plan"
                            }
                          ]
                      },
                    "value": "2798233",
                    "name": "MEDICARE PART A"
                  }
                ]
            },
          "search":
            {
              "mode": "match"
            }
        },
        {
          "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage/PH-99038104-98497601",
          "resource":
            {
              "resourceType": "Coverage",
              "id": "PH-99038104-98497601",
              "meta":
                {
                  "versionId": "1-0",
                  "lastUpdated": "2021-09-01T07:34:48.000Z"
                },
              "text":
                {
                  "status": "extensions",
                  "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Encounter</b>: 98497601</p><p><b>Beneficiary</b>: RCSHRORDAUTHA, PATA</p><p><b>Coverage Start Date</b>: Sep  1, 2021  7:32 A.M. UTC</p><p><b>Payor</b>: Government</p><p><b>Type</b>: public healthcare</p></div>"
                },
              "extension":
                [
                  {
                    "valueReference":
                      {
                        "reference": "Encounter/98497601"
                      },
                    "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/coverage-encounter"
                  }
                ],
              "status": "active",
              "type":
                {
                  "coding":
                    [
                      {
                        "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                        "code": "PUBLICPOL",
                        "display": "public healthcare"
                      }
                    ],
                  "text": "public healthcare"
                },
              "beneficiary":
                {
                  "reference": "Patient/13554095",
                  "display": "RCSHRORDAUTHA, PATA"
                },
              "period":
                {
                  "start": "2021-09-01T07:32:23.000Z"
                },
              "payor":
                [
                  {
                    "display": "Government"
                  }
                ]
            },
          "search":
            {
              "mode": "match"
            }
        },
        {
          "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/COV-98497601-INT.enccov-99038102",
          "resource":
            {
              "resourceType": "Provenance",
              "id": "COV-98497601-INT.enccov-99038102",
              "meta":
                {
                  "versionId": "99038102",
                  "lastUpdated": "2021-09-01T07:34:48Z"
                },
              "text":
                {
                  "status": "generated",
                  "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>Coverage/98497601-99038102</li></ul><p><b>Recorded</b>: Sep  1, 2021  2:34 A.M. CDT</p><p><b>Agents</b>:</p><dl><dt>Black, Terri Cerner</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd><dt>RVRORGANIZATION</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd></dl></div>"
                },
              "target":
                [
                  {
                    "reference": "Coverage/98497601-99038102"
                  }
                ],
              "recorded": "2021-09-01T07:34:48Z",
              "agent":
                [
                  {
                    "type":
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                              "code": "author"
                            }
                          ],
                        "text": "Author"
                      },
                    "role":
                      [
                        {
                          "coding":
                            [
                              {
                                "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                                "code": "SOURCE"
                              }
                            ],
                          "text": "Source"
                        }
                      ],
                    "who":
                      {
                        "reference": "Practitioner/11876048",
                        "display": "Black, Terri Cerner"
                      },
                    "onBehalfOf":
                      {
                        "reference": "Organization/3294036",
                        "display": "RVRORGANIZATION"
                      }
                  },
                  {
                    "type":
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                              "code": "author"
                            }
                          ],
                        "text": "Author"
                      },
                    "role":
                      [
                        {
                          "coding":
                            [
                              {
                                "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                                "code": "SOURCE"
                              }
                            ],
                          "text": "Source"
                        }
                      ],
                    "who":
                      {
                        "reference": "Organization/3294036",
                        "display": "RVRORGANIZATION"
                      }
                  }
                ]
            },
          "search":
            {
              "mode": "include"
            }
        },
        {
          "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/COV-PH-98497601-INT.enccov-99038104",
          "resource":
            {
              "resourceType": "Provenance",
              "id": "COV-PH-98497601-INT.enccov-99038104",
              "meta":
                {
                  "versionId": "99038104",
                  "lastUpdated": "2021-09-01T07:34:48Z"
                },
              "text":
                {
                  "status": "generated",
                  "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>Coverage/PH-99038104-98497601</li></ul><p><b>Recorded</b>: Sep  1, 2021  2:34 A.M. CDT</p><p><b>Agents</b>:</p><dl><dt>Black, Terri Cerner</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd><dt>RVRORGANIZATION</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd></dl></div>"
                },
              "target":
                [
                  {
                    "reference": "Coverage/PH-99038104-98497601"
                  }
                ],
              "recorded": "2021-09-01T07:34:48Z",
              "agent":
                [
                  {
                    "type":
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                              "code": "author"
                            }
                          ],
                        "text": "Author"
                      },
                    "role":
                      [
                        {
                          "coding":
                            [
                              {
                                "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                                "code": "SOURCE"
                              }
                            ],
                          "text": "Source"
                        }
                      ],
                    "who":
                      {
                        "reference": "Practitioner/11876048",
                        "display": "Black, Terri Cerner"
                      },
                    "onBehalfOf":
                      {
                        "reference": "Organization/3294036",
                        "display": "RVRORGANIZATION"
                      }
                  },
                  {
                    "type":
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                              "code": "author"
                            }
                          ],
                        "text": "Author"
                      },
                    "role":
                      [
                        {
                          "coding":
                            [
                              {
                                "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                                "code": "SOURCE"
                              }
                            ],
                          "text": "Source"
                        }
                      ],
                    "who":
                      {
                        "reference": "Organization/3294036",
                        "display": "RVRORGANIZATION"
                      }
                  }
                ]
            },
          "search":
            {
              "mode": "include"
            }
        }
      ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.

x-search-id-with-_revinclude Response

Example search by _id using _revinclude.
Example Request:
GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?_id=13410103-490794713-490794713&_revinclude=Provenance:target
Example Response:

  {
    "resourceType": "Bundle",
    "id": "38c16fab-2b9d-4d80-ac76-2b5bbcb85175",
    "type": "searchset",
    "total": 2,
    "link":
    [
      {
        "relation": "self",
        "url": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?_id=13410103-490794713-490794713&_revinclude=Provenance:target"
      }
    ],
    "entry":
    [
      {
        "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage/13410103-490794713-490794713",
        "resource":
          {
            "resourceType": "Coverage",
            "id": "13410103-490794713-490794713",
            "meta":
              {
                "versionId": "0-0",
                "lastUpdated": "2021-07-15T06:49:37.000Z"
              },
            "text":
              {
                "status": "generated",
                "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Subscriber</b>: RVRHRDOC, PERSONB</p><p><b>Beneficiary</b>: RVRHRDOC, PERSONB</p><p><b>Relationship</b>: self</p><p><b>Coverage Start Date</b>: Jul 15, 2021 12:00 A.M. CDT</p><p><b>Payor</b>: ERM Eligibility Payer</p><p><b>Class</b>:</p><dl><dt>Plan</dt><dd><b>Value</b>: 3338411</dd><dd><b>Name</b>: ERM ELIGIBILITY HP</dd></dl></div>"
              },
            "identifier":
              [
                {
                  "extension":
                    [
                      {
                        "valueCode": "unknown",
                        "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
                      }
                    ]
                }
              ],
            "status": "active",
            "type":
              {
                "coding":
                  [
                    {
                      "system": "urn:oid:2.16.840.1.113883.3.221.5",
                      "code": "5",
                      "display": "PRIVATE HEALTH INSURANCE",
                      "userSelected": false
                    }
                  ],
                "text": "Private Health Insurance"
              },
            "subscriber":
              {
                "reference": "Patient/13410103",
                "display": "RVRHRDOC, PERSONB"
              },
            "beneficiary":
              {
                "reference": "Patient/13410103",
                "display": "RVRHRDOC, PERSONB"
              },
            "relationship":
              {
                "coding":
                  [
                    {
                      "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                      "code": "SELF",
                      "display": "self",
                      "userSelected": false
                    },
                    {
                      "system": "http://terminology.hl7.org/CodeSystem/subscriber-relationship",
                      "code": "self",
                      "display": "Self",
                      "userSelected": false
                    }
                  ],
                "text": "Self"
              },
            "period":
              {
                "start": "2021-07-15T05:00:00.000Z"
              },
            "payor":
              [
                {
                  "reference": "Organization/3312036",
                  "display": "ERM Eligibility Payer"
                }
              ],
            "class":
              [
                {
                  "type":
                    {
                      "coding":
                        [
                          {
                            "system": "http://terminology.hl7.org/CodeSystem/coverage-class",
                            "code": "plan"
                          }
                        ]
                    },
                  "value": "3338411",
                  "name": "ERM ELIGIBILITY HP"
                }
              ]
          },
        "search":
          {
            "mode": "match"
          }
      },
      {
        "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/COV-13410103-490794713-INT.patcov-490794713",
        "resource":
          {
            "resourceType": "Provenance",
            "id": "COV-13410103-490794713-INT.patcov-490794713",
            "meta":
              {
                "versionId": "490794713",
                "lastUpdated": "2021-07-15T06:49:37Z"
              },
            "text":
              {
                "status": "generated",
                "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>Coverage/13410103-490794713-490794713</li></ul><p><b>Recorded</b>: Jul 15, 2021  1:49 A.M. CDT</p><p><b>Agents</b>:</p><dl><dt>Manjunath, Pavithra</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd><dt>Default Prov Org</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd></dl></div>"
              },
            "target":
              [
                {
                  "reference": "Coverage/13410103-490794713-490794713"
                }
              ],
            "recorded": "2021-07-15T06:49:37Z",
            "agent":
              [
                {
                  "type":
                    {
                      "coding":
                        [
                          {
                            "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                            "code": "author"
                          }
                        ],
                      "text": "Author"
                    },
                  "role":
                    [
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                              "code": "SOURCE"
                            }
                          ],
                        "text": "Source"
                      }
                    ],
                  "who":
                    {
                      "reference": "Practitioner/12812091",
                      "display": "Manjunath, Pavithra"
                    },
                  "onBehalfOf":
                    {
                      "reference": "Organization/3398035",
                      "display": "Default Prov Org"
                    }
                },
                {
                  "type":
                    {
                      "coding":
                        [
                          {
                            "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                            "code": "author"
                          }
                        ],
                      "text": "Author"
                    },
                  "role":
                    [
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                              "code": "SOURCE"
                            }
                          ],
                        "text": "Source"
                      }
                    ],
                  "who":
                    {
                      "reference": "Organization/3398035",
                      "display": "Default Prov Org"
                    }
                }
              ]
          },
        "search":
          {
            "mode": "include"
          }
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.

x-search-patient-public-with-_revinclude Response

Example search by patient using _revinclude.
Example Request:
GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?patient=13410103&_revinclude=Provenance:target
Example Response:

  {
    "resourceType": "Bundle",
    "id": "a11e4940-0220-4ffa-97ea-8e6e722f97ee",
    "type": "searchset",
    "total": 4,
    "link":
      [
        {
          "relation": "self",
          "url": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage?patient=13410103&_revinclude=Provenance:target"
        }
      ],
    "entry":
      [
        {
          "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage/13410103-490794713-490794713",
          "resource":
            {
              "resourceType": "Coverage",
              "id": "13410103-490794713-490794713",
              "meta":
                {
                  "versionId": "0-0",
                  "lastUpdated": "2021-07-15T06:49:37.000Z"
                },
              "text":
                {
                  "status": "generated",
                  "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Subscriber</b>: RVRHRDOC, PERSONB</p><p><b>Beneficiary</b>: RVRHRDOC, PERSONB</p><p><b>Relationship</b>: self</p><p><b>Coverage Start Date</b>: Jul 15, 2021 12:00 A.M. CDT</p><p><b>Payor</b>: ERM Eligibility Payer</p><p><b>Class</b>:</p><dl><dt>Plan</dt><dd><b>Value</b>: 3338411</dd><dd><b>Name</b>: ERM ELIGIBILITY HP</dd></dl></div>"
                },
              "identifier":
                [
                  {
                    "extension":
                      [
                        {
                          "valueCode": "unknown",
                          "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason"
                        }
                      ]
                  }
                ],
              "status": "active",
              "type":
                {
                  "coding":
                    [
                      {
                        "system": "urn:oid:2.16.840.1.113883.3.221.5",
                        "code": "5",
                        "display": "PRIVATE HEALTH INSURANCE",
                        "userSelected": false
                      }
                    ],
                  "text": "Private Health Insurance"
                },
              "subscriber":
                {
                  "reference": "Patient/13410103",
                  "display": "RVRHRDOC, PERSONB"
                },
              "beneficiary":
                {
                  "reference": "Patient/13410103",
                  "display": "RVRHRDOC, PERSONB"
                },
              "relationship":
                {
                  "coding":
                    [
                      {
                        "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
                        "code": "SELF",
                        "display": "self",
                        "userSelected": false
                      },
                      {
                        "system": "http://terminology.hl7.org/CodeSystem/subscriber-relationship",
                        "code": "self",
                        "display": "Self",
                        "userSelected": false
                      }
                    ],
                  "text": "Self"
                },
              "period":
                {
                  "start": "2021-07-15T05:00:00.000Z"
                },
              "payor":
                [
                  {
                    "reference": "Organization/3312036",
                    "display": "ERM Eligibility Payer"
                  }
                ],
              "class":
                [
                  {
                    "type":
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/coverage-class",
                              "code": "plan"
                            }
                          ]
                      },
                    "value": "3338411",
                    "name": "ERM ELIGIBILITY HP"
                  }
                ]
            },
          "search":
            {
              "mode": "match"
            }
        },
        {
          "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Coverage/PHP-490794715-13410103",
          "resource":
            {
              "resourceType": "Coverage",
              "id": "PHP-490794715-13410103",
              "meta":
                {
                  "versionId": "0-0",
                  "lastUpdated": "2021-07-15T06:49:37.000Z"
                },
              "text":
                {
                  "status": "generated",
                  "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Coverage</b></p><p><b>Status</b>: Active</p><p><b>Beneficiary</b>: RVRHRDOC, PERSONB</p><p><b>Coverage Start Date</b>: Jul 15, 2021  6:49 A.M. UTC</p><p><b>Payor</b>: Government</p><p><b>Type</b>: public healthcare</p></div>"
                },
              "status": "active",
              "type":
                {
                  "coding":
                    [
                      {
                        "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
                        "code": "PUBLICPOL",
                        "display": "public healthcare"
                      }
                    ],
                  "text": "public healthcare"
                },
              "beneficiary":
                {
                  "reference": "Patient/13410103",
                  "display": "RVRHRDOC, PERSONB"
                },
              "period":
                {
                  "start": "2021-07-15T06:49:37.000Z"
                },
              "payor":
                [
                  {
                    "display": "Government"
                  }
                ]
            },
          "search":
            {
              "mode": "match"
            }
        },
        {
          "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/COV-13410103-490794713-INT.patcov-490794713",
          "resource":
            {
              "resourceType": "Provenance",
              "id": "COV-13410103-490794713-INT.patcov-490794713",
              "meta":
                {
                  "versionId": "490794713",
                  "lastUpdated": "2021-07-15T06:49:37Z"
                },
              "text":
                {
                  "status": "generated",
                  "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>Coverage/13410103-490794713-490794713</li></ul><p><b>Recorded</b>: Jul 15, 2021  1:49 A.M. CDT</p><p><b>Agents</b>:</p><dl><dt>Manjunath, Pavithra</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd><dt>Default Prov Org</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd></dl></div>"
                },
              "target":
                [
                  {
                    "reference": "Coverage/13410103-490794713-490794713"
                  }
                ],
              "recorded": "2021-07-15T06:49:37Z",
              "agent":
                [
                  {
                    "type":
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                              "code": "author"
                            }
                          ],
                        "text": "Author"
                      },
                    "role":
                      [
                        {
                          "coding":
                            [
                              {
                                "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                                "code": "SOURCE"
                              }
                            ],
                          "text": "Source"
                        }
                      ],
                    "who":
                      {
                        "reference": "Practitioner/12812091",
                        "display": "Manjunath, Pavithra"
                      },
                    "onBehalfOf":
                      {
                        "reference": "Organization/3398035",
                        "display": "Default Prov Org"
                      }
                  },
                  {
                    "type":
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                              "code": "author"
                            }
                          ],
                        "text": "Author"
                      },
                    "role":
                      [
                        {
                          "coding":
                            [
                              {
                                "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                                "code": "SOURCE"
                              }
                            ],
                          "text": "Source"
                        }
                      ],
                    "who":
                      {
                        "reference": "Organization/3398035",
                        "display": "Default Prov Org"
                      }
                  }
                ]
            },
          "search":
            {
              "mode": "include"
            }
        },
        {
          "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/COV-PHP-13410103-INT.patcov-490794715",
          "resource":
            {
              "resourceType": "Provenance",
              "id": "COV-PHP-13410103-INT.patcov-490794715",
              "meta":
                {
                  "versionId": "490794715",
                  "lastUpdated": "2021-07-15T06:49:37Z"
                },
              "text":
                {
                  "status": "generated",
                  "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>Coverage/PHP-490794715-13410103</li></ul><p><b>Recorded</b>: Jul 15, 2021  1:49 A.M. CDT</p><p><b>Agents</b>:</p><dl><dt>Manjunath, Pavithra</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd><dt>Default Prov Org</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd></dl></div>"
                },
              "target":
                [
                  {
                    "reference": "Coverage/PHP-490794715-13410103"
                  }
                ],
              "recorded": "2021-07-15T06:49:37Z",
              "agent":
                [
                  {
                    "type":
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                              "code": "author"
                            }
                          ],
                        "text": "Author"
                      },
                    "role":
                      [
                        {
                          "coding":
                            [
                              {
                                "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                                "code": "SOURCE"
                              }
                            ],
                          "text": "Source"
                        }
                      ],
                    "who":
                      {
                        "reference": "Practitioner/12812091",
                        "display": "Manjunath, Pavithra"
                      },
                    "onBehalfOf":
                      {
                        "reference": "Organization/3398035",
                        "display": "Default Prov Org"
                      }
                  },
                  {
                    "type":
                      {
                        "coding":
                          [
                            {
                              "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                              "code": "author"
                            }
                          ],
                        "text": "Author"
                      },
                    "role":
                      [
                        {
                          "coding":
                            [
                              {
                                "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                                "code": "SOURCE"
                              }
                            ],
                          "text": "Source"
                        }
                      ],
                    "who":
                      {
                        "reference": "Organization/3398035",
                        "display": "Default Prov Org"
                      }
                  }
                ]
            },
          "search":
            {
              "mode": "include"
            }
        }
      ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.
Back to Top