Skip to content

Coverage resource (FHIR R4)

Coverage is the FHIR R4 resource for financial instrument which may be used to reimburse or pay for health care products and services.

ResourceCoverage
FHIR versionR4 (4.0.1)
Canonical URLhttp://hl7.org/fhir/StructureDefinition/Coverage
Required elementsstatus (1..1), beneficiary (1..1), payor (1..*)
IG profiles in this catalog3

Example

{
  "resourceType": "Coverage",
  "id": "coverage-e8c21a8da7c1d9832816a999ad7c518f",
  "status": "active",
  "type": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
        "code": "HIP",
        "display": "health insurance plan policy"
      }
    ]
  },
  "subscriber": {
    "reference": "Patient/patient-L46A6EIB9J",
    "display": "Fuentes, Ola"
  },
  "subscriberId": "UHC-823978447",
  "beneficiary": {
    "reference": "Patient/patient-L46A6EIB9J"
  },
  "relationship": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/subscriber-relationship",
        "code": "self",
        "display": "Self"
      }
    ]
  },
  "period": {
    "start": "2025-07-01",
    "end": "2027-07-01"
  },
  "payor": [
    {
      "display": "UnitedHealthcare"
    }
  ],
  "class": [
    {
      "type": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/coverage-class",
            "code": "group"
          }
        ]
      },
      "value": "GRP-45405",
      "name": "UnitedHealthcare Group Plan"
    },
    {
      "type": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/coverage-class",
            "code": "plan"
          }
        ]
  ...

Generated by the Pidgeon engine: pidgeon generate Coverage --seed 20260722. Truncated for display; the command reproduces the full resource.

Validation context

  • strict pidgeon validate grades a Coverage instance against the base R4 structure definition: missing required elements raise REQUIRED_FIELD_MISSING and cardinality violations raise CARDINALITY_MIN or CARDINALITY_MAX.(REQUIRED_FIELD_MISSING)
  • strict Profile validation grades the same instance against an installed IG profile: profile cardinality findings carry FHIR-PROFILE-CARDINALITY and terminology binding findings carry FHIR-PROFILE-BINDING.(FHIR-PROFILE-CARDINALITY)

This answer, in your terminal

pidgeon lookup Coverage

Wire it into your AI agent:

claude mcp add pidgeon -- npx -y @pidgeonhealth/mcp

Download Post free to browse this reference with generation attached.

FHIR® R4 © Health Level Seven International. FHIR R4 specification content is used under its CC0 license; this page is a derivative work and is not endorsed by HL7 International.

HL7® and FHIR® are registered trademarks of Health Level Seven International.

Published by Pattern Engine LLC (Pidgeon Health).

Rendered from the same machine-readable definitions the Pidgeon engine validates against. Exported from the Pidgeon engine's FHIR R4 definitions (CC0); example generated with seed 20260722.