API Changelog
This page tracks changes to the Orders API contract across releases.
It focuses on the GraphQL contract files and validation rules that most directly affect external vendors:
*.graphql (input types, output types, enums, and queries) and validations.ts (runtime validation rules).
For full developer release notes see the internal CHANGELOG (opens in a new tab).
v14.2.4
Input Changes
OrderInput changes:
- Added field
relatedOrderRequisitionNumber(optional) (feature-gated, not yet in production)
Enum Changes
TumorClinicalStatusEnum changes:
- Added value
PRIMARY
v14.2.0
Schema Changes
OrderInput changes:
- Added field
monitoringSequence(optional) (feature-gated, not yet in production)
Enum Changes
New enum MonitoringSequenceEnum with values:
EVERY_4_WEEKSEVERY_6_WEEKSEVERY_8_WEEKSEVERY_3_MONTHSEVERY_6_MONTHSEVERY_12_MONTHSSINGLENONE
v13.2.0
Schema Changes
ClinicalDetailInput changes:
- Added field
plannedSurgeryDate(optional) (feature-gated, not yet in production) - Added field
treatmentTimepoint(optional) (feature-gated, not yet in production)
Enum Changes
New enum TreatmentTimepointEnum with values:
PRIOR_TO_NEOADJUVANT_THERAPYNEOADJUVANT_THERAPYCURATIVE_SURGERYADJUVANT_THERAPYPOST_ADJUVANT_MONITORINGOTHER
v13.1.1
Input Changes
MRDBloodSpecimenInput changes:
- Removed field
requestFromPatient - Field
collectionDateis now required
Validation Changes
- Mrd Blood Specimen validation added
- MRD validation added: "An MRD blood specimen requires a corresponding MRDBaseline or MRDMonitoring product"
- Specimens — added rule: "Invalid specimen, you must specify a specimen of type germline, mrdblood, or tumor"; removed rule: "Invalid specimen, you must specify a specimen of type germline or tumor"
v13.0.0
Input Changes
New input types added:
MRDBloodSpecimenInput
SpecimenInput changes:
- Added field
mrdblood(optional) (feature-gated, not yet in production)
Enum Changes
ProductTypeEnum changes:
- Added value
MRDBASELINE(feature-gated, not yet in production) - Added value
MRDMONITORING(feature-gated, not yet in production)
SpecimenTypeEnum changes:
- Added value
MRDBLOOD(feature-gated, not yet in production)
v11.13.0
Validation Changes
- Cancer Types Diagnosis Age validation added
v11.12.1
Validation Changes
- Germline Specimen — removed rule: "Hospitalization code should not be provided for specimens requested from the patient"
v11.5.4
Enum Changes
TumorClinicalStatusEnum changes:
- Added value
METASTATIC
v11.1.0
Schema Changes
FamilyCancerHistoryDetailsInput changes:
- Added field
cancerType(optional)
Enum Changes
New enum CancerTypeEnum with values:
PAPILLARYFOLLICULARMEDULLARYOTHER
Validation Changes
- Thyroid Cancer Type For Family History — Added: "Thyroid cancer type should not be provided when cancer site is not thyroid"
- Cancer Types validation added
v11.0.1
Enum Changes
ProductTypeEnum changes:
- Added value
HER2
v11.0.0
Schema Changes
New types / inputs added:
kidneyRenalCancerDiagnosisDetailsKidneyRenalCancerHistoryRetinoblastomaCancerDiagnosisDetailsRetinoblastomaCancerHistoryOvarianNonEpithelialCancerDiagnosisDetailsOvarianNonEpithelialCancerHistory
CancerHistoryInput changes:
- Added field
adrenalAdenoma(optional) - Added field
adrenalCarcinoma(optional) - Added field
astrocytoma(optional) - Added field
basalCellCarcinoma(optional) - Added field
carcinoidTumor(optional) - Added field
duodenalNeuroendocrineTumor(optional) - Added field
gastrointestinalStromalTumor(optional) - Added field
meningioma(optional) - Added field
mesothelioma(optional) - Added field
neurofibroma(optional) - Added field
pancreaticNeuroendocrineTumor(optional) - Added field
paraganglioma(optional) - Added field
parathyroidAdenomaHyperplasia(optional) - Added field
parathyroidCarcinoma(optional) - Added field
pheochromocytoma(optional) - Added field
pituitaryAdenoma(optional) - Added field
pituitaryCarcinoma(optional) - Added field
retinoblastoma(optional) - Added field
schwannoma(optional) - Added field
testicular(optional) - Added field
thymus(optional) - Deprecated:
adrenalAdenomasCancer
Enum Changes
New enum KidneyRenalCancerTypeEnum with values:
FUMARATE_HYDRATASESUCCINATE_DEHYDROGENASEONCOCYTOMAONCOCYTIC_HYBRIDCHROMOPHOBE_RENALPAPILLARY_RENALOTHER
New enum OvarianNonEpithelialCancerTypeEnum with values:
SERTOLI_LEYDIGOTHER
CancerSiteEnum changes:
- Added value
ADRENAL_ADENOMA - Added value
ADRENAL_CARCINOMA - Added value
ASTROCYTOMA - Added value
BASAL_CELL_CARCINOMA - Added value
CARCINOID_TUMOR - Added value
DUODENAL_NEUROENDOCRINE_TUMOR - Added value
GASTROINTESTINAL_STROMAL_TUMOR - Added value
MENINGIOMA - Added value
MESOTHELIOMA - Added value
NEUROFIBROMA - Added value
PANCREATIC_NEUROENDOCRINE_TUMOR - Added value
PARAGANGLIOMA - Added value
PARATHYROID_ADENOMA_HYPERPLASIA - Added value
PARATHYROID_CARCINOMA - Added value
PHEOCHROMOCYTOMA - Added value
PITUITARY_ADENOMA - Added value
PITUITARY_CARCINOMA - Added value
RETINOBLASTOMA - Added value
SCHWANNOMA - Added value
TESTICULAR - Added value
THYMUS - Deprecated:
ADRENAL_ADENOMAS_CANCER— This value is deprecated and will be removed in a future version. UseADRENAL_ADENOMAorADRENAL_CARCINOMAinstead.
v10.16.0
Input Changes
BreastCancerHistory changes:
- Added field
rawDiseaseName(optional)
CervicalCancerHistory changes:
- Added field
rawDiseaseName(optional)
ColorectalCancerHistory changes:
- Added field
rawDiseaseName(optional)
EndometrialCancerHistory changes:
- Added field
rawDiseaseName(optional)
FallopianTubeCancerHistory changes:
- Added field
rawDiseaseName(optional)
GastricCancerHistory changes:
- Added field
rawDiseaseName(optional)
LungCancerHistory changes:
- Added field
rawDiseaseName(optional)
OvarianCancerHistory changes:
- Added field
rawDiseaseName(optional)
PancreaticCancerHistory changes:
- Added field
rawDiseaseName(optional)
PeritonealCancerHistory changes:
- Added field
rawDiseaseName(optional)
ProstateCancerHistory changes:
- Added field
rawDiseaseName(optional)
AdenomasPolypsCancerHistory changes:
- Added field
rawDiseaseName(optional)
CancerHistoryDetails changes:
- Added field
rawDiseaseName(optional)
ThyroidCancerHistory changes:
- Added field
rawDiseaseName(optional)
v10.12.0
Schema Changes
New types / inputs added:
ThyroidDiagnosisDetailsThyroidCancerHistory
FamilyCancerHistoryDetailsInput changes:
- Added field
nccnHighRisk(optional) - Added field
left(optional) - Added field
right(optional)
Enum Changes
New enum ThyroidCancerTypeEnum with values:
PAPILLARYFOLLICULARMEDULLARYOTHER
New enum CollectionOwnerEnum with values:
MYRIADPROVIDER
Enums removed:
collectionOwnerEnum
v10.11.0
Input Changes
OrderInput changes:
- Added field
numberOfAttachmentsToBeUploaded(optional)
Output Type Changes
CreateOrderResponse changes:
- Added field
presignedAttachmentUrls(optional)
Validation Changes
- Presigned Urls Selection validation added
v10.8.0
Input Changes
InstitutionalBillingInput changes:
- Field
institutionalAccountNumberis now required
v10.6.3
Input Changes
TumorSpecimenInput changes:
- Field
tissueTypeCodeis now optional - Field
tumorHistoryis now optional
v10.6.0
Schema Changes
New types / inputs added:
AdenomasPolypsDiagnosisDetailsCancerHistoryDetailsInput
Types / inputs removed:
AdenomatousPolypsRange
ColorectalDiagnosisDetails changes:
- Added field
cancerSeverity(optional)
EndometrialDiagnosisDetails changes:
- Added field
cancerSeverity(optional)
FallopianTubeDiagnosisDetails changes:
- Added field
cancerSeverity(optional)
GastricDiagnosisDetails changes:
- Added field
cancerSeverity(optional)
LungDiagnosisDetails changes:
- Added field
cancerSeverity(optional)
OvarianDiagnosisDetails changes:
- Added field
cancerSeverity(optional)
ProstateCancerDiagnosisDetails changes:
- Added field
cancerSeverity(optional) - Deprecated:
metastatic - Deprecated:
nccnHighRisk - Deprecated:
intraductalHistology
CervicalDiagnosisDetails changes:
- Added field
cancerSeverity(optional)
PancreaticDiagnosisDetails changes:
- Added field
cancerSeverity(optional)
PeritonealDiagnosisDetails changes:
- Added field
cancerSeverity(optional)
CancerHistoryDetails changes:
- Added field
diagnosisDetails(optional)
v10.5.4
Input Changes
DiagnosisAgeRangeInput changes:
- Field
lowerAgeis now optional - Field
upperAgeis now optional
v10.5.3
Validation Changes
- Live Birth — removed rule: "Age at first birth is required when status is true"
v10.5.2
Validation Changes
- Tumor Specimen — added rule: "Prostate tumor stage can only be provided if prostate tumor history is present"
v10.5.1
Input Changes
BreastCancerDiagnosisDetails changes:
- Added field
cancerType(optional)
Enum Changes
New enum BreastCancerTypeEnum with values:
MUCINOUSMICROPAPILLARYNEUROENDOCRINE
v10.5.0
Input Changes
New input types added:
GastricDiagnosisDetailsGastricCancerHistory
Enum Changes
New enum GastricCancerTypeEnum with values:
ADENOCARCINOMAADENOSQUAMOUS_CARCINOMADIFFUSE_ADENOCARCINOMAGASTROBLASTOMAINTESTINAL_ADENOCARCINOMAMIXEDNEUROENDOCRINEOTHERSQUAMOUS_CELL_CARCINOMAUNDIFFERENTIATED
v10.4.5
Enum Changes
TissueTypeEnum changes:
- Added value
FALLOPIAN_TUBE - Added value
PERITONEUM
CervicalCancerTypeEnum changes:
- Added value
ADENOSQUAMOUS
FallopianTubeCancerTypeEnum changes:
- Added value
LOW_GRADE_SEROUS_CARCINOMA - Added value
ENDOMETRIOID
OvarianCancerTypeEnum changes:
- Added value
MIXED_EPITHELIAL_AND_MESENCHYMAL - Added value
CLEAR_CELL
v10.4.4
Input Changes
SpecimenRetrievalInput changes:
- Field
officeContactNameis now optional
v10.4.0
Schema Changes
ClinicalDetailInput changes:
- Added field
personalCancerHistoryKnown(optional) - Deprecated:
noPersonalCancerHistory
v10.1.2
Input Changes
TumorSpecimenInput changes:
- Added field
collectionOwner(optional)
Enum Changes
New enum collectionOwnerEnum with values:
MYRIADPROVIDER
v8.1.0
Input Changes
TumorSpecimenInput changes:
- Added field
methodOfCollection(optional)
Enum Changes
New enum SpecimenMethodOfCollectionEnum with values:
BIOPSYPROSTATECTOMYSURGICAL_RESECTIONOTHER
v7.10.0
Input Changes
LiveBirthInput changes:
- Added field
status(optional)
Validation Changes
- Live Birth validation added: "Age at first birth is required when status is true"; "Age at first birth should not be provided when status is false"; "Age at first birth must be a positive number"
v7.9.1
Input Changes
LiveBirthInput changes:
- Removed field
status
Validation Changes
- Live Birth validation removed
v7.9.0
Input Changes
LiveBirthInput changes:
- Added field
status(required)
Validation Changes
- Live Birth validation added: "Live birth status must be a boolean"; "Age at first birth is required when status is true"; "Age at first birth should not be provided when status is false"; "Age at first birth must be a positive number"
v7.5.0
Schema Changes
ClinicalDetailInput changes:
- Added field
noPersonalCancerHistory(optional) - Added field
familyCancerHistoryKnown(optional)
Validation Changes
- Personal Cancer History — Added: "Personal cancer history should not be provided when noPersonalCancerHistory is true"
- Family Cancer History — Added: "Family cancer history should not be provided when familyCancerHistoryKnown is false"
v7.4.0
Input Changes
New input types added:
SpecimenRetrievalInput
TumorSpecimenInput changes:
- Added field
specimenRetrieval(optional)
Enum Changes
New enum SpecimenRetrievalEnum with values:
PATHOLOGIST
RoleEnum changes:
- Removed value
PATHOLOGIST
v7.1.1
Input Changes
PatientAddressInput changes:
- Field
stateCodeis now optional
Validation Changes
- Patient Address — removed rule: "Patient State Code is required"
v7.1.0
Input Changes
New input types added:
CervicalDiagnosisDetailsPancreaticDiagnosisDetailsPeritonealDiagnosisDetails
Input types removed:
AdditionalHistopathology
TumorSpecimenInput changes:
- Field
tissueTypeCodeis now required
ColorectalDiagnosisDetails changes:
- Added field
cancerType(optional)
EndometrialDiagnosisDetails changes:
- Added field
cancerType(optional) - Removed field
additionalHistopathology
FallopianTubeDiagnosisDetails changes:
- Added field
cancerType(optional) - Removed field
additionalHistopathology
LungDiagnosisDetails changes:
- Added field
cancerType(optional) - Removed field
additionalHistopathology
OvarianDiagnosisDetails changes:
- Added field
cancerType(optional) - Removed field
additionalHistopathology
ProstateCancerDiagnosisDetails changes:
- Added field
cancerType(optional) - Removed field
additionalHistopathology
CancerHistoryInput changes:
- Added field
osteomas(optional) - Removed field
ostemas
Enum Changes
New enum OriginatingSenderEnum with values:
PROVIDER_PORTALEMR_EPICEMR_FLATIRONEMR_SPECIALTYEMR_TXOLKEMR_LUMEAEMR_DNAVISITEMR_NESTGENOMICSEMR_CANCERIQEMR_FINCHJAPAN_PORTALCRM
New enum ProstateCancerTypeEnum with values:
ADENOCARCINOMAINTRADUCTAL_CARCINOMANEUROENDOCRINEUROTHELIAL_TRANSITIONALOTHER
New enum CervicalCancerTypeEnum with values:
ADENOCARCINOMASQUAMOUS_CELLOTHER
New enum ColorectalCancerTypeEnum with values:
ADENOCARCINOMANEUROENDOCRINEOTHER
New enum EndometrialCancerTypeEnum with values:
ENDOMETRIAL_CARCINOMASARCOMAOTHER
New enum FallopianTubeCancerTypeEnum with values:
HIGH_GRADE_SEROUS_CARCINOMAOTHER
New enum LungCancerTypeEnum with values:
ADENOCARCINOMASQUAMOUS_CELL_CARCINOMASMALL_CELL_CARCINOMANON_SMALL_CELL_CARCINOMAOTHER
New enum OvarianCancerTypeEnum with values:
HIGH_GRADE_SEROUS_CARCINOMAOTHER
New enum PancreaticCancerTypeEnum with values:
ADENOCARCINOMANEUROENDOCRINEOTHER
New enum PeritonealCancerTypeEnum with values:
HIGH_GRADE_SEROUS_CARCINOMAOTHER
Enums removed:
ProstateTumorHistologyEnum
v7.0.0
Enum Changes
Enums removed:
OriginatingSenderEnum
v6.1.1
Input Changes
Input types removed:
PolypsCancerHistory
BreastCancerHistory changes:
- Field
diagnosisDetailsis now optional
PeritonealCancerHistory changes:
- Field
diagnosisDetailsis now optional
AdenomasPolypsCancerHistory changes:
- Field
diagnosisDetailsis now optional
v6.1.0
Enum Changes
ProductTypeEnum changes:
- Removed value
PDL1
UpdateToProductTypeEnum changes:
- Added value
PDL1
Validation Changes
- PDL1 validation added: "PDL1 is only available for PreciseTumor"
- FRA validation added: "FRA cannot be updated"
v6.0.4
Enum Changes
OriginatingSenderEnum changes:
- Added value
EMR_DNAVISIT - Added value
EMR_NESTGENOMICS - Added value
EMR_CANCERIQ - Added value
EMR_FINCH
v6.0.3
Input Changes
FamilyCancerHistoryDetailsInput changes:
- Field
diagnosisAgeis now optional
v6.0.2
Input Changes
SingleSiteInput changes:
- Removed field
maternalPaternal
Enum Changes
Enums removed:
SingleSiteRelationahipTypeEnumSingleSiteMaternalPaternalEnum
v4.12.1
Input Changes
New input types added:
DiagnosisCodeInput
ClinicalDetailInput changes:
- Added field
diagnosisCodes(optional)
Enum Changes
DiagnosisCodeEnum changes:
- Removed value
ICD9
Output Type Changes
Output types removed:
AccessionBillingDetailCancerHistoryClinicalDetailCoverageResultDiagnosisCodeEmailAddressDeprecatedFamilyCancerHistoryInsurancePolicyLookupTypeOrderPhoneNumberPolicyTestRelatedOrderTestTestBilling
v4.12.0
Input Changes
New input types added:
PreferencesInput
OrderInput changes:
- Added field
preferences(optional) - Removed field
testPreferenceCode
v4.11.0
Input Changes
Input types removed:
ColonCancerHistory
v4.10.1
Input Changes
FamilyCancerHistoryDetailsInput changes:
- Added field
adenomaRangeCode(optional) - Added field
gleasonScore(optional) - Added field
metastatic(optional)
v4.9.0
Input Changes
CancerHistoryInput changes:
- Added field
genericBreastCancer(optional) - Added field
other(optional)
v4.8.2
Input Changes
BreastCancerDiagnosisDetails changes:
- Added field
previousEndocrineTherapyCode(optional)
v4.8.1
Enum Changes
GenderEnum changes:
- Added value
UNKNOWN
v4.8.0
Input Changes
BillingDetailInput changes:
- Added field
other(optional)
Enum Changes
New enum OtherBillingOptionEnum with values:
UNINSURED
Enums removed:
BillingOptionEnum
v4.7.0
Enum Changes
ProductTypeEnum changes:
- Added value
SINGLESITE
v4.3.0
Enum Changes
OriginatingSenderEnum changes:
- Added value
EMR_SPECIALTY - Removed value
EMR_SPECIALTY_NETWORKS
v4.2.0
Schema Changes
New types / inputs added:
SingleSiteInput
ClinicalDetailInput changes:
- Added field
singleSite(optional)
Enum Changes
New enum SingleSiteRelationahipTypeEnum with values:
MOTHERFATHERFULL_BROTHERHALF_BROTHERFULL_SISTERHALF_SISTERAUNTUNCLECOUSINGRANDFATHERGRANDMOTHERSONDAUGHTERNIECENEPHEW
New enum SingleSiteMaternalPaternalEnum with values:
MATERNALPATERNAL
v4.1.2
Enum Changes
New enum OriginatingSenderEnum with values:
PROVIDER_PORTALEMR_EPICEMR_FLATIRONEMR_SPECIALTY_NETWORKSEMR_TXOLKEMR_LUMEAJAPAN_PORTALCRM
v4.1.0
Output Type Changes
OrderResponse changes:
- Added field
caseId(optional) - Added field
providerAccounts(optional)
Organization changes:
- Removed field
partOf
v4.0.2
Validation Changes
- Products validation added
- Prolaris Personal Cancer History validation added: "missingFieldsError.slice(0, -2"
- Prolaris validation added
- Germline Specimen — added rule: "Collection date should not be provided for specimens requested from the patient"; "Hospitalization code should not be provided for specimens requested from the patient"; "Collection date is required for specimens not requested from the patient"
- Patient Address — removed rule: "Patient Postal code must be 5 digits, 9 digits, or 5 digits plus a dash and 4 digit extension"
v3.0.3
Input Changes
New input types added:
ProviderAddressInputPatientAddressInput
Input types removed:
AddressInput
PatientInput changes:
- Field
addressis now required
Validation Changes
- Provider Address validation added: "Postal code must be 5 digits, 9 digits, or 5 digits plus a dash and 4 digit extension"
- Patient Address validation added: "Patient Street is required"; "Patient City is required"; "Patient State Code is required"; "Patient State Code must be a 2 character abbreviation"; "Patient Postal code is required"; "Patient Postal code must be 5 digits, 9 digits, or 5 digits plus a dash and 4 digit extension"
- Address validation removed
v1.30.1
Validation Changes
- Specimens — added rule: "Invalid specimens, there can be at most 1 specimen of the same type"; "Specimen cannot be empty"; "Invalid specimen, only one specimen type is allowed"; "Invalid specimen, you must specify a specimen of type germline or tumor"; removed rule: "A specimen cannot be both germline and tumor"
v1.28.0
Input Changes
ProductInput changes:
- Removed field
pdl1AdditionalTesting
Enum Changes
ProductTypeEnum changes:
- Added value
PDL1 - Added value
FRA
Output Type Changes
Products changes:
- Removed field
pdl1AdditionalTesting
v1.27.1
Validation Changes
- Address — added rule: "Postal code must be 5 digits, 9 digits, or 5 digits plus a dash and 4 digit extension"; removed rule: "Postal code must be 5 digits or 5 digits plus a dash and 4 digit extension"
v1.27.0
Validation Changes
- Postal Code — Modified: rule updated to "Postal code must be 5 digits or 5 digits plus a dash and 4 digit extension" (replaced previous "5 or 9 digits" rule)
v1.26.0
Input Changes
ProviderInput changes:
- Field
lastNameis now required - Field
firstNameis now required
v1.22.0
Input Changes
ProductInput changes:
- Added field
pdl1AdditionalTesting(optional)
TumorSpecimenInput changes:
- Added field
prostateTumorStage(optional)
ProstateCancerDiagnosisDetails changes:
- Added field
gleasonPrimaryGrade(optional) - Added field
gleasonSecondaryGrade(optional) - Added field
additionalHistopathology(optional)
Enum Changes
New enum ProstateTumorStageEnum with values:
T1AT1BT1CT2AT2BT2CT3AT3BT4
New enum ProstateTumorHistologyEnum with values:
ADENOCARCINOMAINTRADUCTAL_CARCINOMANEUROENDOCRINEUROTHELIAL_TRANSITIONALOTHER
GleasonScores changes:
- Added value
THREE_PLUS_FIVE_EQUAL_EIGHT - Added value
FIVE_PLUS_THREE_EQUAL_EIGHT
Output Type Changes
Products changes:
- Added field
pdl1AdditionalTesting(optional)
v1.21.0
Output Type Changes
New output types added:
CreateOrderResponseOrderResponse
v1.18.0
Schema Changes
TumorSpecimenInput changes:
- Field
collectionDateis now required - Field
tumorHistoryis now required
Validation Changes
- Germline Specimen — Added: collection date is required unless specimen is requested from patient
- Tumor Specimen validation added
- Specimens — Added: "A specimen cannot be both germline and tumor"
- Address — Added: "Postal code must be 5 or 9 digits"
- Phone Number — Added: "Invalid phone number"
- Non Empty Array validation added
- Provider Accounts — Added: "Location address or identifiers are required"
v1.16.0
Input Changes
ProstateCancerDiagnosisDetails changes:
- Added field
biopsyCoresBiopsied(optional) - Added field
biopsyCoresPositives(optional) - Added field
preBiopsyTreatment(optional)
Enum Changes
ProductTypeEnum changes:
- Added value
PROLARIS
v1.3.0
Input Changes
OrderInput changes:
- Added field
attachments(optional)