nci-cidc-api-modules 1.2.34__py3-none-any.whl → 1.2.45__py3-none-any.whl

cidc_api/models/pydantic/stage1/disease.py

@@ -0,0 +1,158 @@
+from pydantic import NonPositiveInt, model_validator, BeforeValidator
+from typing import List, Self, Annotated, get_args
+
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import (
+    TumorGrade,
+    CancerStageSystem,
+    CancerStageSystemVersion,
+    CancerStageSystemVersionAJCC,
+    CancerStageSystemVersionRISS,
+    CancerStageSystemVersionFIGO,
+    CancerStage,
+    TCategory,
+    NCategory,
+    MCategory,
+    UberonAnatomicalTerm,
+    ICDO3MorphologicalCode,
+    ICDO3MorphologicalTerm,
+    YNU,
+)
+
+
+class Disease(Base):
+    __data_category__ = "disease"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for this disease record
+    disease_id: int | None = None
+
+    # The unique internal identifier for the associated participant
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=12220014%20and%20ver_nr=1
+    participant_id: str | None = None
+
+    # The location within the body from where the disease of interest originated as captured in the Uberon identifier. e.g. "lung"
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=14883047%20and%20ver_nr=1
+    primary_disease_site: UberonAnatomicalTerm
+
+    # The ICD-O-3 morphology code that describes the tumor's histology, behavior, and grade-differentiation. e.g. "8480/6"
+    # CDE: TBD
+    morphological_code: ICDO3MorphologicalCode | None
+
+    # The ICD-O-3 morphology term that describes the tumor's type. e.g. "Mucinous adenoma"
+    # CDE: TBD
+    morphological_term: ICDO3MorphologicalTerm | None
+
+    # Words that broadly describe the cancer's characteristics and type. e.g. "Inflitrating Ductal Carcinoma"
+    # CDE: TBD
+    cancer_type_description: str | None = None
+
+    # The number of days elapsed since the participant was first diagnosed with this condition.
+    days_since_original_diagnosis: NonPositiveInt | None
+
+    # Words that express the degree of abnormality of cancer cells as a measure of differentiation and aggressiveness. e.g. "G1 Low Grade"
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=11325685%20and%20ver_nr=2
+    tumor_grade: TumorGrade | None = None
+
+    # The name of the staging system used in the evaluation of the disease. e.g. "AJCC"
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=7429602%20and%20ver_nr=1
+    cancer_stage_system: CancerStageSystem
+
+    # Release version of the staging system used in the evaluation of the disease. e.g. "8" (for AJCC)
+    cancer_stage_system_version: CancerStageSystemVersion | None = None
+
+    # Stage of the cancer at enrollment date as determined by the specific staging system. e.g. "Stage 0" (for AJCC)
+    # CDE(AJCC): https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=3440332%20and%20ver_nr=1
+    # CDE(FIGO): TBD
+    # CDE(RISS): TBD
+    cancer_stage: CancerStage | None = None
+
+    # Extent of the primary cancer based on evidence obtained from clinical assessment parameters determined prior to treatment. e.g. "T0"
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=3440328%20and%20ver_nr=1
+    # TODO: Verify this CDE
+    t_category: TCategory | None = None
+
+    # Extent of the regional lymph node involvement for the cancer based on evidence obtained from clinical assessment parameters
+    # determined prior to treatment. e.g. "N0"
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=3440330%20and%20ver_nr=1
+    # TODO: Verify this CDE
+    n_category: NCategory | None = None
+
+    # Extent of the distant metastasis for the cancer based on evidence obtained from clinical assessment parameters determined
+    # prior to treatment. e.g. "M0"
+    # CDE: https://teams.microsoft.com/l/message/19:1c292b63-5df1-4f29-b177-86aed53f393d_f224ae83-209b-4cd9-a7ef-83d9d2120a27@unq.gbl.spaces/1758827414202?context=%7B%22contextType%22%3A%22chat%22%7D
+    # TODO: Verify this CDE
+    m_category: MCategory | None = None
+
+    # The organ site where a tumor develops outside of the bone marrow as specified in the Uberon antatomical term.
+    metastatic_organ: Annotated[List[UberonAnatomicalTerm] | None, BeforeValidator(Base.split_list)] = []
+
+    # Indicates if participant has a hematological malignancy that is only extramedullary. e.g. "Yes"
+    solely_extramedullary_disease: YNU
+
+    extramedullary_organ: Annotated[List[UberonAnatomicalTerm] | None, BeforeValidator(Base.split_list)] = []
+
+    @model_validator(mode="after")
+    def validate_code_or_term_or_description_cr(self) -> Self:
+        if not self.morphological_code and not self.morphological_term and not self.cancer_type_description:
+            raise ValueError(
+                'Please provide at least one of "morphological_code", "morphological_term" or "cancer_type_description".'
+            )
+        return self
+
+    @model_validator(mode="after")
+    def validate_cancer_stage_system_version(self) -> Self:
+        msg = f"{self.cancer_stage_system_version} is not applicable to {self.cancer_stage_system}"
+        if self.cancer_stage_system == "AJCC" and self.cancer_stage_system_version not in get_args(
+            CancerStageSystemVersionAJCC
+        ):
+            raise ValueError(msg)
+        elif self.cancer_stage_system == "RISS" and self.cancer_stage_system_version not in get_args(
+            CancerStageSystemVersionRISS
+        ):
+            raise ValueError(msg)
+        elif self.cancer_stage_system == "FIGO" and self.cancer_stage_system_version not in get_args(
+            CancerStageSystemVersionFIGO
+        ):
+            raise ValueError(msg)
+        return self
+
+    @model_validator(mode="after")
+    def validate_cancer_stage_system_version_cr(self) -> Self:
+        if self.cancer_stage_system != "Not Applicable" and not self.cancer_stage_system_version:
+            raise ValueError(
+                f'Please provide cancer_stage_system_version when cancer_stage_system is "{self.cancer_stage_system}"'
+            )
+        return self
+
+    @model_validator(mode="after")
+    def validate_cancer_stage_cr(self) -> Self:
+        if self.cancer_stage_system != "Not Applicable" and not self.cancer_stage:
+            raise ValueError(f'Please provide cancer_stage when cancer_stage_system is "{self.cancer_stage_system}"')
+        return self
+
+    @model_validator(mode="after")
+    def validate_t_category_cr(self) -> Self:
+        if self.cancer_stage_system == "AJCC" and not self.t_category:
+            raise ValueError(f'Please provide t_category when cancer_stage_system is "{self.cancer_stage_system}"')
+        return self
+
+    @model_validator(mode="after")
+    def validate_n_category_cr(self) -> Self:
+        if self.cancer_stage_system == "AJCC" and not self.n_category:
+            raise ValueError(f'Please provide n_category when cancer_stage_system is "{self.cancer_stage_system}"')
+        return self
+
+    @model_validator(mode="after")
+    def validate_m_category_cr(self) -> Self:
+        if self.cancer_stage_system == "AJCC" and not self.m_category:
+            raise ValueError(f'Please provide m_category when cancer_stage_system is "{self.cancer_stage_system}"')
+        return self
+
+    @model_validator(mode="after")
+    def validate_extramedullary_organ_cr(self) -> Self:
+        if self.solely_extramedullary_disease in ["No", "Unknown"] and self.extramedullary_organ:
+            raise ValueError(
+                "If solely_extramedullary_disease indicates no disease, please leave extramedullary_organ blank."
+            )
+        return self

cidc_api/models/pydantic/stage1/exposure.py

@@ -0,0 +1,32 @@
+from typing import Self
+
+from pydantic import model_validator
+
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import YNU, ExposureType
+
+
+class Exposure(Base):
+    __data_category__ = "exposure"
+    __cardinality__ = "many"
+
+    # A unique internal identifier for the exposure
+    exposure_id: int | None = None
+
+    # The unique identifier for the associated participant
+    participant_id: str | None = None
+
+    # An indication of whether the subject was exposed to any chemical, biological or physical agents
+    # that increase the risk of neoplasms in humans or animals.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=5205578%20and%20ver_nr=3
+    carcinogen_exposure: YNU
+
+    # The type of potentially harmful environmental agents to which an individual was exposed.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=15753203%20and%20ver_nr=1
+    exposure_type: ExposureType | None = None
+
+    @model_validator(mode="after")
+    def validate_exposure_type_cr(self) -> Self:
+        if self.carcinogen_exposure in ["No", "Unknown"] and self.exposure_type:
+            raise ValueError("If carcinogen_exposure indicates non exposure, please leave exposure_type blank.")
+        return self

cidc_api/models/pydantic/stage1/gvhd_diagnosis_acute.py

@@ -0,0 +1,33 @@
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import (
+    GVHDDiagnosisAcuteAssessmentSystem,
+    GVHDDiagnosisAcuteAssessmentSystemVersion,
+    GVHDDiagnosisAcuteGrade,
+    PreOrPostEnrollment,
+)
+
+
+class GVHDDiagnosisAcute(Base):
+    __data_category__ = "gvhd_diagnosis_acute"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for the GVHD Diagnosis Acute Record
+    gvhd_diagnosis_acute_id: int | None = None
+
+    # The unique internal identifier for the associated participant
+    participant_id: str | None = None
+
+    # The clinical grading system used to stage involvement of affected organs (skin, liver, GI tract)
+    # in acute GVHD and assign an overall severity grade (I–IV) based on predefined criteria.
+    acute_assessment_system: GVHDDiagnosisAcuteAssessmentSystem
+
+    # Release version of the clinical grading system used in the evaluation of acute GVHD.
+    system_version: GVHDDiagnosisAcuteAssessmentSystemVersion
+
+    # The overall severity grade (I–IV) assigned to a patient with acute GVHD based on the extent of
+    # involvement in affected organs (skin, liver, and GI tract), determined using a standardized
+    # assessment system.
+    acute_grade: GVHDDiagnosisAcuteGrade
+
+    # Indicator for whether the acute GVHD diagnosis was made before or after trial enrollment.
+    pre_or_post_enrollment: PreOrPostEnrollment

cidc_api/models/pydantic/stage1/gvhd_diagnosis_chronic.py

@@ -0,0 +1,32 @@
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import (
+    GVHDDiagnosisChronicAssessmentSystem,
+    GVHDDiagnosisChronicAssessmentSystemVersion,
+    GVHDDiagnosisChronicGlobalSeverity,
+    PreOrPostEnrollment,
+)
+
+
+class GVHDDiagnosisChronic(Base):
+    __data_category__ = "gvhd_diagnosis_chronic"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for the GVHD chronic diagnosis
+    gvhd_diagnosis_chronic_id: int | None = None
+
+    # The unique internal identifier for the associated participant
+    participant_id: str | None = None
+
+    # The standardized clinical system used to evaluate and grade the extent and severity
+    # of organ involvement in chronic GVHD, resulting in an overall disease severity score.
+    chronic_assessment_system: GVHDDiagnosisChronicAssessmentSystem
+
+    # Release version of the clinical grading system used in the evaluation of chronic GVHD.
+    system_version: GVHDDiagnosisChronicAssessmentSystemVersion
+
+    # An overall score reflecting the combined severity of chronic graft-versus-host disease
+    # across all affected organs, summarizing the participant’s total disease burden.
+    chronic_global_severity: GVHDDiagnosisChronicGlobalSeverity
+
+    # Indicator for whether the chronic GVHD diagnosis was made before or after trial enrollment.
+    pre_or_post_enrollment: PreOrPostEnrollment

cidc_api/models/pydantic/stage1/gvhd_organ_acute.py

@@ -0,0 +1,22 @@
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import (
+    GVHDOrgan,
+    GVHDOrganAcuteStage,
+)
+
+
+class GVHDOrganAcute(Base):
+    __data_category__ = "gvhd_organ_acute"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for the GVHD Organ Acute Record
+    gvhd_organ_acute_id: int | None = None
+
+    # The unique internal identifier for the associated GVHD Diagnosis Acute record
+    gvhd_diagnosis_acute_id: int | None = None
+
+    # An organ affected by acute GVHD for which the stage is assessed as part of the overall acute GVHD evaluation.
+    organ: GVHDOrgan
+
+    # The severity level of an individual organ’s involvement in acute GVHD, usually scored from 0 (none) to 4 (severe).
+    acute_stage: GVHDOrganAcuteStage

cidc_api/models/pydantic/stage1/gvhd_organ_chronic.py

@@ -0,0 +1,23 @@
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import (
+    GVHDOrgan,
+    GVHDOrganChronicScore,
+)
+
+
+class GVHDOrganChronic(Base):
+    __data_category__ = "gvhd_organ_chronic"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for the GVHD Organ Chronic Record
+    gvhd_organ_chronic_id: int | None = None
+
+    # The unique internal identifier for the associated GVHD Diagnosis Chronic record
+    gvhd_diagnosis_chronic_id: int | None = None
+
+    # An organ affected by chronic GVHD identified by its Uberon ontology ID
+    # and evaluated for severity as part of the overall chronic GVHD assessment.
+    organ: GVHDOrgan
+
+    # The severity score for an individual organ affected by chronic GVHD based on clinical criteria.
+    chronic_score: GVHDOrganChronicScore

cidc_api/models/pydantic/stage1/medical_history.py

@@ -0,0 +1,36 @@
+from typing import Self
+
+from pydantic import NonNegativeInt, PositiveFloat, model_validator
+
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import TobaccoSmokingStatus
+
+
+class MedicalHistory(Base):
+    __data_category__ = "medical_history"
+    __cardinality__ = "one"
+
+    # A unique internal identifier for the medical history
+    medical_history_id: int | None = None
+
+    # The unique identifier for the associated participant
+    participant_id: str | None = None
+
+    # Text representation of a person's status relative to smoking tobacco in the form of cigarettes,
+    # based on questions about current and former use of cigarettes.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=16333929%20and%20ver_nr=1
+    tobacco_smoking_status: TobaccoSmokingStatus | None = None
+
+    # Average number of packs of cigarettes smoked per day multiplied by number of years the participant has smoked.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=6841869%20and%20ver_nr=1
+    pack_years_smoked: PositiveFloat | None = None
+
+    # Number of prior systemic therapies.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=16089302%20and%20ver_nr=1
+    num_prior_systemic_therapies: NonNegativeInt | None = None
+
+    @model_validator(mode="after")
+    def validate_pack_years_smoked_cr(self) -> Self:
+        if self.tobacco_smoking_status in ["Never Smoker", "Unknown", "Not reported"] and self.pack_years_smoked:
+            raise ValueError("If tobacco_smoking_status indicates non-smoker, please leave pack_years_smoked blank.")
+        return self

cidc_api/models/pydantic/stage1/other_malignancy.py

@@ -0,0 +1,49 @@
+from typing import Self
+
+from pydantic import NonPositiveInt, model_validator
+
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import UberonAnatomicalTerm, ICDO3MorphologicalCode, ICDO3MorphologicalTerm, MalignancyStatus
+
+
+class OtherMalignancy(Base):
+    __data_category__ = "other_malignancy"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for the OtherMalignancy record
+    other_malignancy_id: int | None = None
+
+    # The unique internal identifier for the associated MedicalHistory record
+    medical_history_id: int | None = None
+
+    # The location within the body from where the prior malignancy originated as captured in the Uberon anatomical term.
+    other_malignancy_primary_disease_site: UberonAnatomicalTerm
+
+    # The ICD-O-3 code which identifies the specific appearance of cells and tissues (normal and abnormal) used
+    # to define the presence and nature of disease.
+    other_malignancy_morphological_code: ICDO3MorphologicalCode | None = None
+
+    # The ICD-O-3 textual label which identifies the specific appearance of cells and tissues (normal and abnormal) used
+    # to define the presence and nature of disease.
+    other_malignancy_morphological_term: ICDO3MorphologicalTerm | None = None
+
+    # Description of the cancer type as recorded in the trial.
+    other_malignancy_description: str | None = None
+
+    # Number of days since original diagnosis from the enrollment date. This may be a negative number.
+    other_malignancy_days_since_diagnosis: NonPositiveInt | None = None
+
+    # Indicates the participant’s current clinical state regarding the cancer diagnosis.
+    other_malignancy_status: MalignancyStatus | None = None
+
+    @model_validator(mode="after")
+    def validate_code_or_term_or_description_cr(self) -> Self:
+        if (
+            not self.other_malignancy_morphological_code
+            and not self.other_malignancy_morphological_term
+            and not self.other_malignancy_description
+        ):
+            raise ValueError(
+                'Please provide at least one of "morphological_code", "morphological_term" or "malignancy_description".'
+            )
+        return self

cidc_api/models/pydantic/stage1/participant.py

@@ -0,0 +1,51 @@
+from typing import Self
+
+from pydantic import model_validator
+
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import YNU
+from cidc_api.models.types import OffStudyReason
+
+
+class Participant(Base):
+    __data_category__ = "participant"
+    __cardinality__ = "one"
+
+    # The unique internal identifier for the participant
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=12220014%20and%20ver_nr=1
+    participant_id: str | None = None
+
+    # The participant identifier assigned by the clinical trial team overseeing the study
+    native_participant_id: str | None = None
+
+    # The globally unique participant identifier assigned by the CIMAC network. e.g. C8P29A7
+    cimac_participant_id: str | None = None
+
+    # The unique identifier for the associated trial that the participant is participating in
+    trial_id: str | None = None
+
+    # The version number of the trial dataset. e.g. "1.0"
+    version: str | None = None
+
+    # Indicates if the individual is no longer actively participating in the clinical trial.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=14834973%20and%20ver_nr=1
+    off_study: YNU
+
+    # An explanation describing why an individual is no longer participating in the clinical trial.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=13362265%20and%20ver_nr=1
+    off_study_reason: OffStudyReason | None = None
+
+    # Additional information if "Other" is selected for off_study_reason. e.g. "Transfer to another study"
+    off_study_reason_other: str | None = None
+
+    @model_validator(mode="after")
+    def off_study_reason_cr(self) -> Self:
+        if self.off_study == "Yes" and not self.off_study_reason:
+            raise ValueError('If "off_study" is "Yes" then "off_study_reason" is required.')
+        return self
+
+    @model_validator(mode="after")
+    def off_study_reason_other_cr(self) -> Self:
+        if self.off_study_reason == "Other" and not self.off_study_reason_other:
+            raise ValueError('If "off_study_reason" is "Other" then "off_study_reason_other" is required.')
+        return self

cidc_api/models/pydantic/stage1/prior_treatment.py

@@ -0,0 +1,45 @@
+from typing import Self, Annotated, List
+
+from pydantic import NonPositiveInt, NegativeInt, model_validator, BeforeValidator
+
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import ConditioningRegimenType, StemCellDonorType
+
+
+class PriorTreatment(Base):
+    __data_category__ = "prior_treatment"
+    __cardinality__ = "many"
+
+    # A unique internal identifier for the prior treatment record
+    prior_treatment_id: int | None = None
+
+    # A unique internal identifier for the associated participant record
+    participant_id: str | None = None
+
+    # Number of days from the enrollment date to the first recorded administration or occurrence of
+    # the treatment modality.
+    prior_treatment_days_to_start: NonPositiveInt | None = None
+
+    # Number of days from the enrollment date to the last recorded administration or occurrence of
+    # the treatment modality.
+    prior_treatment_days_to_end: NonPositiveInt | None = None
+
+    # Specifies the category or kind of prior treatment modality a participant received.
+
+    # Description of the prior treatment such as its full generic name if it is a type of therapy agent,
+    # radiotherapy procedure name and location, or surgical procedure name and location.
+    prior_treatment_description: str
+
+    # Best response from any response assessment system to the prior treatment if available or applicable.
+    prior_treatment_best_response: str | None = None
+
+    # If the prior treatment is "Conditioning therapy" received before a stem cell transplant, specifies what
+    # type of conditioning regimen used.
+    prior_treatment_conditioning_regimen_type: ConditioningRegimenType | None = None
+
+    # If prior treatment is "Stem cell transplant", indicates what stem cell donor type used.
+    prior_treatment_stem_cell_donor_type: StemCellDonorType | None = None
+
+    # If prior treatment is "Stem cell transplant", indicates the number of days from enrollment
+    # to the prior transplant. This must be a negative number.
+    prior_treatment_days_from_transplant_to_treatment_initiation: NegativeInt | None = None

cidc_api/models/pydantic/stage1/radiotherapy_dose.py

@@ -0,0 +1,79 @@
+from typing import Self
+
+from pydantic import NonNegativeInt, NonNegativeFloat, model_validator
+
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import (
+    YNU,
+    RadiotherapyProcedure,
+    UberonAnatomicalTerm,
+    RadiotherapyDoseUnits,
+    RadiationExtent,
+)
+
+
+class RadiotherapyDose(Base):
+    __data_category__ = "radiotherapy_dose"
+    __cardinality__ = "many"
+
+    # The unique internal identifier for the radiotherapy dose record
+    radiotherapy_dose_id: int | None = None
+
+    # The unique internal identifier for the associated treatment record
+    treatment_id: int | None = None
+
+    # Number of days from enrollment date to the start of the radiotherapy dose.
+    days_to_start: NonNegativeInt
+
+    # Number of days from enrollment date to the end of the radiotherapy dose.
+    days_to_end: NonNegativeInt
+
+    # The term that describes the kind of radiotherapy procedure administered.
+    procedure: RadiotherapyProcedure
+
+    # The Uberon anatomical term for the site of surgery.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=14461856%20and%20ver_nr=1
+    anatomical_location: UberonAnatomicalTerm | None = None
+
+    # Indicates whether the record represents the total dose for a radiotherapy treatment course (which may be either
+    # a multi-fractionated or a single-fraction dose).
+    is_total_dose: bool
+
+    # The number of fractions a participant received to deliver the radiation dose.
+    number_of_fractions: NonNegativeInt | None = None
+
+    # The dose amount received by the participant.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=13433490%20and%20ver_nr=1
+    received_dose: NonNegativeFloat
+
+    # Unit of measure for the dose of the radiotherapy to be received by the participant.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=13383458%20and%20ver_nr=1
+    received_dose_units: RadiotherapyDoseUnits
+
+    # The planned dose amount for the participant.
+    planned_dose: NonNegativeFloat | None = None
+
+    # Unit of measure for the planned total dose of the radiotherapy to be received by the participant.
+    planned_dose_units: RadiotherapyDoseUnits | None = None
+
+    # Indicates if the radiotherapy dose was changed, missed, or delayed.
+    dose_changes_delays: YNU
+
+    # Description of the radiotherapy dose changes, misses, or delays.
+    changes_delays_description: str | None = None
+
+    # The extent of radiation exposure administered to the patient's body during radiation therapy.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=7063755%20and%20ver_nr=1
+    radiation_extent: RadiationExtent
+
+    @model_validator(mode="after")
+    def validate_changes_delays_description_cr(self) -> Self:
+        if self.dose_changes_delays == "Yes" and not self.changes_delays_description:
+            raise ValueError('If dose_changes_delays is "Yes", please provide changes_delays_description.')
+        return self
+
+    @model_validator(mode="after")
+    def validate_planned_dose_units_cr(self) -> Self:
+        if self.planned_dose and not self.planned_dose_units:
+            raise ValueError("If planned_dose is provided, please provide planned_dose_units.")
+        return self

cidc_api/models/pydantic/stage1/response.py

@@ -0,0 +1,65 @@
+from typing import Self
+
+from pydantic import NonNegativeInt, model_validator
+
+from cidc_api.models.pydantic.base import Base
+from cidc_api.models.types import SurvivalStatus, YNUNA, CauseOfDeath
+
+
+class Response(Base):
+    __data_category__ = "response"
+    __cardinality__ = "one"
+
+    # The unique internal identifier for the response record
+    response_id: int | None = None
+
+    # The unique internal identifier for the associated participant
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=12220014%20and%20ver_nr=1
+    participant_id: str | None = None
+
+    # The response to a question that describes a participant's survival status.
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=2847330%20and%20ver_nr=1
+    survival_status: SurvivalStatus
+
+    # Number of days from enrollment date to death date.
+    overall_survival: NonNegativeInt
+
+    # Indicator for whether there was an abscopal effect on disease after local therapy.
+    abscopal_response: YNUNA | None = None
+
+    # Indicates if pathological complete response (pCR) occurred.
+    pathological_complete_response: YNUNA | None = None
+
+    # Number of days between enrollment date and date of death, if applicable.
+    days_to_death: NonNegativeInt | None = None
+
+    # The circumstance or condition of greatest rank or importance that results in the death of the participant
+    # CDE: https://cadsr.cancer.gov/onedata/dmdirect/NIH/NCI/CO/CDEDD?filter=CDEDD.ITEM_ID=4783274%20and%20ver_nr=1
+    cause_of_death: CauseOfDeath | None = None
+
+    # Indicates whether participant was evaluable for toxicity (adverse events, DLT, etc.) overall.
+    evaluable_for_toxicity: bool
+
+    # Indicates whether participant was evaluable for efficacy (for example, response, PFS, OS, etc.) overall.
+    evaluable_for_efficacy: bool
+
+    # Days from enrollment date to the last time the patient's vital status was verified.
+    days_to_last_vital_status: NonNegativeInt | None = None  # TODO: Needs CR check
+
+    @model_validator(mode="after")
+    def validate_cause_of_death_cr(self) -> Self:
+        if self.survival_status == "Dead" and not self.cause_of_death:
+            raise ValueError('If survival_status is "Dead" then cause_of_death is required.')
+        return self
+
+    @model_validator(mode="after")
+    def validate_cause_of_death_cr2(self) -> Self:
+        if self.survival_status == "Alive" and self.cause_of_death:
+            raise ValueError('If survival_status is "Alive", please leave cause_of_death blank.')
+        return self
+
+    @model_validator(mode="after")
+    def validate_days_to_death_cr(self) -> Self:
+        if self.survival_status in ["Alive", "Unknown"] and self.days_to_death:
+            raise ValueError("If survival_status does not indicate death, please leave days_to_death blank.")
+        return self