Skip to content

Claim resource (FHIR R4)

Claim is the FHIR R4 resource for a provider issued list of professional services and products which have been provided, or are to be provided, to a patient which is sent to an insurer for reimbursement.

ResourceClaim
FHIR versionR4 (4.0.1)
Canonical URLhttp://hl7.org/fhir/StructureDefinition/Claim
Required elementsstatus (1..1), type (1..1), use (1..1), patient (1..1), created (1..1), provider (1..1), priority (1..1), insurance (1..*)
IG profiles in this catalog4

Example

{
  "resourceType": "Claim",
  "id": "claim-2555bd4c150621d150d8f1bcd8a3b705",
  "status": "active",
  "type": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/claim-type",
        "code": "professional",
        "display": "Professional"
      }
    ]
  },
  "use": "claim",
  "patient": {
    "reference": "Patient/patient-L46A6EIB9J"
  },
  "created": "2026-07-01",
  "provider": {
    "display": "General Hospital"
  },
  "priority": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/processpriority",
        "code": "normal"
      }
    ]
  },
  "diagnosis": [
    {
      "sequence": 1,
      "diagnosisCodeableConcept": {
        "coding": [
          {
            "system": "http://hl7.org/fhir/sid/icd-10-cm",
            "code": "E11.9",
            "display": "Type 2 diabetes mellitus without complications"
          }
        ]
      }
    }
  ],
  "procedure": [
    {
      "sequence": 1,
      "procedureCodeableConcept": {
        "coding": [
          {
            "system": "http://www.ama-assn.org/go/cpt",
            "code": "omitted",
            "display": "CPT code omitted from this published example"
          }
        ]
      }
    }
  ],
  "item": [
    {
      "sequence": 1,
  ...

Generated by the Pidgeon engine: pidgeon generate Claim --seed 20260722. Codes from licensed terminologies (LOINC, SNOMED CT, CPT, RxNorm) are omitted from published examples. Truncated for display; the command reproduces the full resource.

Validation context

  • strict pidgeon validate grades a Claim 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 Claim

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.