# CancerStage - HL7 Europe Common Cancer Model v1.0.0-ballot

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **CancerStage**

## Logical Model: CancerStage 

| | |
| :--- | :--- |
| *Official URL*:http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerStage | *Version*:1.0.0-ballot |
| Active as of 2026-06-14 | *Computable Name*:CancerStage |
| **Copyright/Legal**: HL7 Europe Copyright. Licensed under Common Creative License (CC0 1.0). Details at [Copyright](copyright.md). | |

 
Logical model representing the cancer stage at the time of first diagnosis. The stage may be clinical or pathological: the clinical stage is derived from imaging evidence, while the pathological stage, when available, is derived from surgical evidence. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerStage). 

**Usages:**

* This Logical Model is not used by any profiles in this Specification

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/resource/hl7.fhir.eu.cancer-common|current/StructureDefinition/StructureDefinition-CancerStage.json)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-CancerStage.csv), [Excel](StructureDefinition-CancerStage.xlsx) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "CancerStage",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics",
    "valueCode" : "can-be-target"
  }],
  "url" : "http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerStage",
  "version" : "1.0.0-ballot",
  "name" : "CancerStage",
  "title" : "CancerStage",
  "status" : "active",
  "date" : "2026-06-14T12:51:40+02:00",
  "publisher" : "HL7 Europe",
  "contact" : [{
    "name" : "HL7 Europe",
    "telecom" : [{
      "system" : "url",
      "value" : "http://hl7.eu"
    }]
  }],
  "description" : "Logical model representing the cancer stage at the time of first diagnosis. The stage may be clinical or pathological: the clinical stage is derived from imaging evidence, while the pathological stage, when available, is derived from surgical evidence. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerStage).",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "150",
      "display" : "Europe"
    }]
  }],
  "copyright" : "HL7 Europe Copyright. Licensed under Common Creative License (CC0 1.0). Details at [Copyright](copyright.html).",
  "fhirVersion" : "4.0.1",
  "kind" : "logical",
  "abstract" : false,
  "type" : "http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerStage",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Base",
  "derivation" : "specialization",
  "differential" : {
    "element" : [{
      "id" : "CancerStage",
      "path" : "CancerStage",
      "short" : "CancerStage",
      "definition" : "Logical model representing the cancer stage at the time of first diagnosis. The stage may be clinical or pathological: the clinical stage is derived from imaging evidence, while the pathological stage, when available, is derived from surgical evidence. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerStage).",
      "constraint" : [{
        "key" : "cs-ev-e1",
        "severity" : "error",
        "human" : "If type is Clinical, imaging evidence must not be provided.",
        "source" : "http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerStage"
      },
      {
        "key" : "cs-ev-e2",
        "severity" : "error",
        "human" : "If type is Pathological, surgery evidence must not be provided.",
        "source" : "http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerStage"
      },
      {
        "key" : "cs-tnm-1",
        "severity" : "warning",
        "human" : "If classificationType is TNM, 3 values is expected.",
        "expression" : "classificationType.text = 'TNM' implies stage.count() >= 3",
        "source" : "http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerStage"
      },
      {
        "key" : "cs-nontnm-1",
        "severity" : "warning",
        "human" : "For non-TNM staging systems, a single value is typically expected.",
        "expression" : "classificationType.text != 'TNM' implies stage.count() = 1",
        "source" : "http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerStage"
      }]
    },
    {
      "id" : "CancerStage.cancerConditionAtDiagnosisReference",
      "path" : "CancerStage.cancerConditionAtDiagnosisReference",
      "short" : "CancerCondition AtDiagnosis Reference",
      "definition" : "Reference to the cancer condition at first diagnosis for which the stage is reported.",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerConditionAtDiagnosis"]
      }]
    },
    {
      "id" : "CancerStage.classificationType",
      "path" : "CancerStage.classificationType",
      "short" : "ClassificationType",
      "definition" : "Staging classification system used when the staging system needs to be explicitly identified (e.g. TNM).",
      "comment" : "For TNM, this element should be populated with 'TNM'. For single-value systems, it may be omitted when the system/measure is represented through stageComponent.code.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "CodeableConcept"
      }]
    },
    {
      "id" : "CancerStage.stage",
      "path" : "CancerStage.stage",
      "short" : "StageValue",
      "definition" : "One or more staging values expressed as (code, value) pairs.",
      "comment" : "Most staging systems are represented by a single component. TNM is represented by three components, one for each of T, N, and M (codes 'T', 'N', 'M').",
      "min" : 1,
      "max" : "*",
      "type" : [{
        "code" : "BackboneElement"
      }]
    },
    {
      "id" : "CancerStage.stage.code",
      "path" : "CancerStage.stage.code",
      "short" : "Stage element code",
      "definition" : "Identifies which staging element is being reported (e.g. T category, N category, M category, stage group).",
      "comment" : "For single-value staging systems, this represents the staging system/measure being used (e.g. 'FIGO stage group'). For TNM, expected codes include 'T', 'N', and 'M'.",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "CodeableConcept"
      }]
    },
    {
      "id" : "CancerStage.stage.value",
      "path" : "CancerStage.stage.value",
      "short" : "Stage element value",
      "definition" : "Value associated with the reported staging element (e.g. T2, N1, M0; or a stage group value).",
      "comment" : "For TNM, this carries the component value (e.g. T2, N0, M0). For single-value systems, this carries the stage group/value (e.g. IIIB).",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "CodeableConcept"
      }]
    },
    {
      "id" : "CancerStage.type",
      "path" : "CancerStage.type",
      "short" : "Type",
      "definition" : "It indicates whether the stage instance is of type Clinical or Pathological.",
      "comment" : "It indicates whether the stage instance is of type Clinical or Pathological. Choice: Clinical | Pathological",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "CodeableConcept"
      }]
    },
    {
      "id" : "CancerStage.evidenceReference",
      "path" : "CancerStage.evidenceReference",
      "short" : "EvidenceReference",
      "definition" : "Reference(s) to the evidence used to define the stage: imaging in case of a Clinical stage, or surgery in case of a Pathological stage.",
      "comment" : "It shall be present. The reference shall be to one or more imaging procedures in case the stage is Clinical, or to one surgery in case the stage is Pathological.",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.eu/fhir/cancer-common/StructureDefinition/Surgery",
        "http://hl7.eu/fhir/cancer-common/StructureDefinition/Imaging"]
      }]
    }]
  }
}

```
