Skip to content

Endpoint: /Patient/GetDataCategory ​

This endpoint will allow a GEHRIMED Patient ID, a date or date range, and a specific category, or set of categories, of data to be provided, returning that data for a patient with that GEHRIMED Patient ID. Some categorical data is applicable to date filtering, whereas some is not. The list of applicable categories is as follows:

  • Problem List - no date range filtering
  • Medication Allergies - no date range filtering
  • Unique Device Identifiers for Implantables - no date range filtering
  • Care Team Members - no date range filtering
  • Assessment and Plan of Treatment - no date range filtering
  • Goals - no date range filtering
  • Health Concerns - no date range filtering
  • Procedures - return all procedure records before the "end date", aka do not filter ou
  • Laboratory Tests (Orders) - filter by date order was entered in the database
  • Laboratory Results - returned for any lab order requested, regardless of date result
  • Medications - filter by Date Started and Date Stopped (if null, include)
  • Immunizations - filter by date range
  • Vital Signs - returns vitals from the most recent date on which vitals where captured

Any date range for a category of data that date is not applicable to will be ignored.

When requesting categorical data, any number of categories may be requested at once, using an array of strings called "Categories".

Valid categories are as follows: (and must be requested by this verbatim name)

  • Medications
  • ProblemList
  • MedicationAllergies
  • Immunizations
  • ImplantableDevices
  • Procedures
  • LabOrders
  • Vitals
  • CareTeam
  • TreatmentPlan
  • Goals
  • HealthConcerns

Request : JSON

{
	"PatientID": 154791,
	"StartDate": "2011-11-09",
	"EndDate": "2011-11-09",
	"Categories": [
		"ProblemList",
		"Medications",
		"MedicationAllergies",
		"Immunizations",
		"ImplantableDevices",
		"Procedures",
		"LabOrders",
		"Vitals",
		"CareTeam",
		"TreatmentPlan",
		"Goals",
		"HealthConcerns"
		]
}
FieldData TypeRequiredComments
PatientIDLongRequiredGEHRIMED PatientID
StartDateDateOptionalStart date to filter data on.
EndDateDateOptionalEnd date to filter data on.
CategoriesString[]RequiredArray containing at least one of the categories defined above.
Response will contain data for all categories included in this list.

Response : JSON

{
    "Metadata": {
        "ApiSender": "GEHRIMED",
        "ApiConsumer": "gpm_internal",
        "MessageDateTime": "2018-09-12T16:44:25.850Z"
    },
    "Data": {
        "ProblemList": {
            "ProblemList": [
				{
                    "ICD10": "E66.3",
                    "SNOMED": 238131007,
                    "Status": 3,
                    "StatusText": "Resolved"
                },
                {
                    "ICD10": "R50.9",
                    "SNOMED": 386661006,
                    "Status": 1,
                    "StatusText": "Active"
                },
                {
                    "ICD10": "T86.11",
                    "SNOMED": 236578006,
                    "Status": 1,
                    "StatusText": "Active"
                },
                {
                    "ICD10": "E03.8",
                    "SNOMED": 83986005,
                    "Status": 1,
                    "StatusText": "Active"
                },
                {
                    "ICD10": "I10",
                    "SNOMED": 59621000,
                    "Status": 1,
                    "StatusText": "Active"
                }
            ]
        },
        "Medications": {
            "MedicationList": [
                {
                    "RxNormCode": "731241",
                    "GenericName": "darbepoetin alfa in polysorbat",
                    "BrandName": "Aranesp (in polysorbate)",
                    "Strength": "500 mcg/mL",
                    "Dose": "1",
                    "DoseUnit": "syringe",
                    "Route": "subcutaneously",
                    "Frequency": "once a week",
                    "DateStarted": "2018-08-22T04:00:00.000Z",
                    "Status": "Active",
                    "Quantity": 10,
                    "Refills": 0,
                    "SubstitutionPermitted": true,
                    "PatientNotes": "",
                    "OtherNotes": "",
                    "StopReason": "",
                    "PrescriptionID": "SB-23350062441",
                    "Form": "syringe",
                    "IsSupply": false,
                    "IsCompound": false,
                    "NDC": "55513003201",
                    "ProviderID": 2000020,
                    "Source": "DrFirst",
                    "DoseOther": ""
                },
                {
                    "RxNormCode": "309090",
                    "GenericName": "ceftriaxone",
                    "BrandName": "ceftriaxone",
                    "Strength": "10 gram",
                    "Dose": "1",
                    "DoseUnit": "unit",
                    "Route": "subcutaneously",
                    "Frequency": "twice a day",
                    "DateStarted": "2018-09-04T04:00:00.000Z",
                    "Status": "Active",
                    "Quantity": 20,
                    "Refills": 0,
                    "SubstitutionPermitted": true,
                    "PatientNotes": "",
                    "OtherNotes": "",
                    "StopReason": "",
                    "PrescriptionID": "SB-23350062431",
                    "Form": "recon soln",
                    "IsSupply": false,
                    "IsCompound": false,
                    "NDC": "00781321046",
                    "ProviderID": 2000020,
                    "Source": "DrFirst",
                    "DoseOther": ""
                },
                {
                    "RxNormCode": "209459",
                    "GenericName": "acetaminophen",
                    "BrandName": "Tylenol Extra Strength",
                    "Strength": "500 mg",
                    "Dose": "1",
                    "DoseUnit": "tablet",
                    "Route": "by mouth",
                    "Frequency": "as directed",
                    "DateStarted": "2018-09-04T04:00:00.000Z",
                    "Status": "Active",
                    "Quantity": 10,
                    "Refills": 0,
                    "SubstitutionPermitted": true,
                    "PatientNotes": "",
                    "OtherNotes": "",
                    "StopReason": "",
                    "PrescriptionID": "SB-23350062435",
                    "Form": "tablet",
                    "IsSupply": false,
                    "IsCompound": false,
                    "NDC": "50580044913",
                    "ProviderID": 2000020,
                    "Source": "DrFirst",
                    "DoseOther": "as needed"
                },
                {
                    "RxNormCode": "309090",
                    "GenericName": "ceftriaxone",
                    "BrandName": "ceftriaxone",
                    "Strength": "10 gram",
                    "Dose": "1",
                    "DoseUnit": "unit",
                    "Route": "subcutaneously",
                    "Frequency": "twice a day",
                    "DateStarted": "2018-08-22T04:00:00.000Z",
                    "Status": "Inactive",
                    "Quantity": 20,
                    "Refills": 0,
                    "SubstitutionPermitted": true,
                    "PatientNotes": "",
                    "OtherNotes": "",
                    "StopReason": "",
                    "DateStopped": "2018-09-01T04:00:00.000Z",
                    "PrescriptionID": "SB-23350062431",
                    "Form": "recon soln",
                    "IsSupply": false,
                    "IsCompound": false,
                    "NDC": "00781321046",
                    "ProviderID": 2000020,
                    "Source": "DrFirst",
                    "DoseOther": ""
                },
                {
                    "RxNormCode": "209459",
                    "GenericName": "acetaminophen",
                    "BrandName": "Tylenol Extra Strength",
                    "Strength": "500 mg",
                    "Dose": "1",
                    "DoseUnit": "tablet",
                    "Route": "by mouth",
                    "Frequency": "as directed",
                    "DateStarted": "2018-08-22T04:00:00.000Z",
                    "Status": "Inactive",
                    "Quantity": 10,
                    "Refills": 0,
                    "SubstitutionPermitted": true,
                    "PatientNotes": "",
                    "OtherNotes": "",
                    "StopReason": "",
                    "DateStopped": "2018-09-01T04:00:00.000Z",
                    "PrescriptionID": "SB-23350062435",
                    "Form": "tablet",
                    "IsSupply": false,
                    "IsCompound": false,
                    "NDC": "50580044913",
                    "ProviderID": 2000020,
                    "Source": "DrFirst",
                    "DoseOther": "as needed"
                }
            ]
        },
        "MedicationAllergies": {
            "MedicationAllergyList": [
                {
                    "Allergy": "ampicillin",
                    "Reaction": "Hives: 247472004",
                    "AdverseEventDate": "1980-05-10T04:00:00.000Z",
                    "Status": "Active",
                    "Source": "gEHRiMed",
                    "LastModifiedDate": "2018-08-27T04:00:00.000Z",
                    "DataSource": "DrFirst",
                    "Severity": "Moderate",
                    "NDC": "",
                    "ExternalAllergyID": "2375041000"
                },
                {
                    "Allergy": "penicillin G",
                    "Reaction": "Hives: 247472004",
                    "AdverseEventDate": "1980-05-10T04:00:00.000Z",
                    "Status": "Active",
                    "Source": "gEHRiMed",
                    "LastModifiedDate": "2018-08-27T04:00:00.000Z",
                    "DataSource": "DrFirst",
                    "Severity": "Moderate",
                    "NDC": "",
                    "ExternalAllergyID": "2375040997"
                }
            ]
        },
        "Immunizations": {
            "ImmunizationList": [
                {
                    "VaccineName": "DTaP, 5 pertussis antigens",
                    "DateOfService": "2012-01-04T05:00:00.000Z",
                    "VaccineLotNum": "2",
                    "ManufacturerName": "Immuno-US",
                    "ManufacturerCode": "IUS",
                    "Notes": "",
                    "ImmunizationDate": "2012-01-04T05:00:00.000Z",
                    "CVX": "106",
                    "ProcessStatus": 2,
                    "ReadOnly": false,
                    "Status": "Completed"
                },
                {
                    "VaccineName": "influenza, intradermal, quadrivalent, preservative",
                    "DateOfService": "2015-06-22T04:00:00.000Z",
                    "ManufacturerName": "Immuno-US",
                    "ManufacturerCode": "IUS",
                    "Notes": "Immunization was not given - Patient rejected immunization",
                    "ImmunizationDate": "2015-06-22T04:00:00.000Z",
                    "CVX": "166",
                    "ProcessStatus": 2,
                    "ReadOnly": false,
                    "Status": "Cancelled"
                }
            ]
        },
        "ImplantableDevices": {
            "ImplantableDeviceList": [
                {
                    "UDI": "(01)10884521062856(11)141231(17)150707(10)A213B1(21)1234",
                    "Description": "Polyester suture",
                    "BrandName": "Ti-Cron",
                    "VersionModelNumber": "88863380-82",
                    "CompanyName": "Covidien LP",
                    "MRISafetyStatus": "Labeling does not contain MRI Safety Information",
                    "LabeledContainsNRL": "false",
                    "LotNumber": "A213B1",
                    "SerialNumber": "1234",
                    "ExpirationDate": "2015-07-07",
                    "ManufacturedDate": "2014-12-31",
                    "DeviceIdentifier": "10884521062856",
                    "IsActive": true
                },
                {
                    "UDI": "+B066000325011NS1/$$420020216LOT123456789012345/SXYZ456789012345678/16D20130202C1",
                    "Description": "Cardiopulmonary bypass system filter, arterial blood line",
                    "BrandName": "CAP, NON VENTED FEMALE: BLUE NON-STERILE",
                    "VersionModelNumber": "000325-011NS",
                    "CompanyName": "NOVOSCI CORP.",
                    "MRISafetyStatus": "Labeling does not contain MRI Safety Information",
                    "LabeledContainsNRL": "false",
                    "LotNumber": "LOT123456789012345",
                    "SerialNumber": "XYZ456789012345678",
                    "ExpirationDate": "2020-02-02",
                    "ManufacturedDate": "2013-02-02",
                    "DeviceIdentifier": "B066000325011NS1",
                    "IsActive": true
                },
                {
                    "UDI": "=/W4146EB0010T0475=,000025=A99971312345600=>014032=}013032&,1000000000000XYZ123",
                    "Description": "Cadaveric-donor/synthetic mineral bone graft",
                    "BrandName": "Trabexus® EB",
                    "VersionModelNumber": "10 cc",
                    "CompanyName": "Vivorte, Inc",
                    "MRISafetyStatus": "Labeling does not contain MRI Safety Information",
                    "LabeledContainsNRL": "false",
                    "LotNumber": "000000000000XYZ123",
                    "SerialNumber": "000025",
                    "ExpirationDate": "2014-02-01",
                    "ManufacturedDate": "2013-02-01",
                    "DeviceIdentifier": "W4146EB0010T0475",
                    "DonationID": "A99971312345600",
                    "IsActive": true
                }
            ]
        },
        "Procedures": {
            "ProcedureList": [
                {
                    "DateOfService": "2018-09-10T04:00:00.000Z",
                    "ProcedureCode": "108220007",
                    "Description": "Evaluation AND/OR management - new patient (procedure)",
                    "Comment": "Patient comment",
                    "Status": 1,
                    "LastModifiedBy": 1131
                },
                {
                    "DateOfService": "2018-09-10T04:00:00.000Z",
                    "ProcedureCode": "108224003",
                    "Description": "Preventive patient evaluation (procedure)",
                    "Comment": "Patient evaluation",
                    "Status": 1,
                    "LastModifiedBy": 1131
                }
            ]
        },
        "LabOrders": {
            "LabOrderList": [
                {
                    "RequestedDate": "2015-06-22T04:00:00.000Z",
                    "ScheduledDate": "2015-06-22T04:00:00.000Z",
                    "ServiceCode": "24357-6",
                    "ServiceCodeText": "Urinalysis macro (dipstick) panel - Urine",
                    "TransactionDate": "2015-06-22T04:00:00.000Z",
                    "RequestedBy": 2000020,
                    "StatusCode": 1,
                    "AddedDate": "2018-08-23T04:00:00.000Z",
                    "LabResult": [
                        {
                            "ObservationCode": "5778-6",
                            "ObservationCodeText": "Color of Urine",
                            "ObservationValue": "YELLOW",
                            "ObservationReferenceRange": "YELLOW",
                            "ResultStatus": "F",
                            "PerformingOrganizationName": "Value Labs",
                            "PerformingOrganizationAddress": "2474 Rocky place",
                            "PerformingOrganizationCity": "Beaverton",
                            "PerformingOrganizationState": "OR",
                            "PerformingOrganizationZip": "97006",
                            "StatusCode": 0,
                            "AddedDate": "2018-08-23T04:00:00.000Z"
                        },
                        {
                            "ObservationCode": "5767-9",
                            "ObservationCodeText": "Appearance of Urine",
                            "ObservationValue": "CLEAR",
                            "ObservationReferenceRange": "CLEAR",
                            "ResultStatus": "F",
                            "PerformingOrganizationName": "Value Labs",
                            "PerformingOrganizationAddress": "2474 Rocky place",
                            "PerformingOrganizationCity": "Beaverton",
                            "PerformingOrganizationState": "OR",
                            "PerformingOrganizationZip": "97006",
                            "StatusCode": 0,
                            "AddedDate": "2018-08-23T04:00:00.000Z"
                        },
                        {
                            "ObservationCode": "5811-5",
                            "ObservationCodeText": "Specific gravity of Urine by Test strip",
                            "ObservationValue": "1.015",
                            "ObservationReferenceRange": "1.005-1.030",
                            "ResultStatus": "F",
                            "PerformingOrganizationName": "Value Labs",
                            "PerformingOrganizationAddress": "2474 Rocky place",
                            "PerformingOrganizationCity": "BEAVERTON",
                            "PerformingOrganizationState": "OR",
                            "PerformingOrganizationZip": "97006",
                            "StatusCode": 0,
                            "AddedDate": "2018-08-23T04:00:00.000Z"
                        },
                        {
                            "ObservationCode": "5803-2",
                            "ObservationCodeText": "pH of Urine by Test strip",
                            "ObservationValue": "5.0",
                            "ObservationUnitsText": "pH",
                            "ObservationReferenceRange": "5.0-8.0",
                            "ResultStatus": "F",
                            "PerformingOrganizationName": "Value Labs",
                            "PerformingOrganizationAddress": "2474 Rocky place",
                            "PerformingOrganizationCity": "BEAVERTON",
                            "PerformingOrganizationState": "OR",
                            "PerformingOrganizationZip": "97006",
                            "StatusCode": 0,
                            "AddedDate": "2018-08-23T04:00:00.000Z"
                        },
                        {
                            "ObservationCode": "5792-7",
                            "ObservationCodeText": "Glucose [Mass/volume] in urine by test strip",
                            "ObservationValue": "50",
                            "ObservationUnitsText": "mg/dL",
                            "ObservationReferenceRange": "Neg",
                            "ResultStatus": "F",
                            "PerformingOrganizationName": "Value Labs",
                            "PerformingOrganizationAddress": "2474 Rocky place",
                            "PerformingOrganizationCity": "BEAVERTON",
                            "PerformingOrganizationState": "OR",
                            "PerformingOrganizationZip": "97006",
                            "StatusCode": 0,
                            "AddedDate": "2018-08-23T04:00:00.000Z"
                        },
                        {
                            "ObservationCode": "5797-6",
                            "ObservationCodeText": "Ketones [Mass/Volume] in urine by test strip",
                            "ObservationValue": "NEGATIVE",
                            "ObservationReferenceRange": "Negative",
                            "ResultStatus": "F",
                            "PerformingOrganizationName": "Value Labs",
                            "PerformingOrganizationAddress": "2474 Rocky place",
                            "PerformingOrganizationCity": "BEAVERTON",
                            "PerformingOrganizationState": "OR",
                            "PerformingOrganizationZip": "97006",
                            "StatusCode": 0,
                            "AddedDate": "2018-08-23T04:00:00.000Z"
                        },
                        {
                            "ObservationCode": "5804-0",
                            "ObservationCodeText": "Protein[Mass/Volume] in urine by test strip",
                            "ObservationValue": "100",
                            "ObservationUnitsText": "mg/dL",
                            "ObservationReferenceRange": "Negative",
                            "ResultStatus": "F",
                            "PerformingOrganizationName": "Value Labs",
                            "PerformingOrganizationAddress": "2474 Rocky place",
                            "PerformingOrganizationCity": "BEAVERTON",
                            "PerformingOrganizationState": "OR",
                            "PerformingOrganizationZip": "97006",
                            "StatusCode": 0,
                            "AddedDate": "2018-08-23T04:00:00.000Z"
                        }
                    ]
                },
                {
                    "RequestedDate": "2015-06-29T04:00:00.000Z",
                    "ServiceCode": "24357-6",
                    "ServiceCodeText": "Urinalysis macro (dipstick) panel - Urine",
                    "RequestedBy": 2000020,
                    "StatusCode": 5,
                    "AddedDate": "2018-08-24T04:00:00.000Z"
                }
            ]
        },
        "Vitals": {
            "VitalsList": [
                {
                    "Name": "Weight",
                    "Data": "123",
                    "AdditionalData": "pounds",
                    "DateEntered": "2011-11-09T05:00:00.000Z"
                },
                {
                    "Name": "Height",
                    "Data": "70",
                    "AdditionalData": "inches",
                    "DateEntered": "2011-11-09T05:00:00.000Z"
                },
                {
                    "Name": "Pulse",
                    "Data": "55",
                    "AdditionalData": "BPM",
                    "DateEntered": "2011-11-09T05:00:00.000Z"
                },
                {
                    "Name": "Blood Pressure",
                    "Data": "55/55",
                    "AdditionalData": "",
                    "DateEntered": "2011-11-09T05:00:00.000Z"
                },
                {
                    "Name": "O2 Saturation",
                    "Data": "55",
                    "AdditionalData": "Room Air",
                    "DateEntered": "2011-11-09T05:00:00.000Z"
                },
                {
                    "Name": "Temperature",
                    "Data": "55",
                    "AdditionalData": "Fahrenheit",
                    "DateEntered": "2011-11-09T05:00:00.000Z"
                },
                {
                    "Name": "Respiratory Rate",
                    "Data": "55",
                    "AdditionalData": "Breaths per minute",
                    "DateEntered": "2011-11-09T05:00:00.000Z"
                },
                {
                    "Name": "BMI",
                    "Data": "17.6",
                    "AdditionalData": "",
                    "DateEntered": "2011-11-09T05:00:00.000Z"
                }
            ]
        },
        "CareTeam": {
            "HistoryType": "CCDA Care Team",
            "History": "Lisa Tommy - SN"
        },
        "TreatmentPlan": {
            "HistoryType": "CCDA Care Plan",
            "History": "Treatment plan notes include : item A, item B, recommendation C, order D.<div>Follow up in X months.</div>"
        },
        "Assessment": {
            "HistoryType": "CCDA Assessment Plan",
            "History": "The patient was found to have fever and Dr is suspecting Anemia based on the patient history."
        },
        "Goals": {
            "HistoryType": "CCDA Goals",
            "History": "Reduce body weight by 12 lbs before follow up.<div>Reduce cholesterol intake.</div>"
        },
        "HealthConcerns": {
            "HistoryType": "CCDA Health Concerns",
            "History": "Higher cholesterol than should have, given prescribed diet.<div>Slightly overweight, could be contributing.</div>"
        }
    }
}

MetaData ​

FieldData TypeComments
MetadataMetadataSee Response Metadata section.
DataDataData wrapper that contains category wrappers.

ProblemList ​

FieldData TypeComments
ProblemListProblemListProblem list category wrapper.
ProblemList.ProblemListArrayList of problem list objects.
ProblemList.ProblemList.ICD10StringICD10 code.
ProblemList.ProblemList.SNOMEDIntSNOMED code.
ProblemList.ProblemList.StatusIntStatus code
ProblemList.ProblemList.StatusTextStringStatus description.

Medications ​

FieldData TypeComments
MedicationsMedicationsMedication category wrapper.
Medications.MedicationListArrayList of Medication objects.
Medications.MedicationList.RxNormCodeStringRx Norm database code.
Medications.MedicationList.ProductStringProduct name.
Medications.MedicationList.GenericNameStringGeneric name for product.
Medications.MedicationList.BrandNameStringBrand name.
Medications.MedicationList.StrengthStringStrength of medication.
Medications.MedicationList.DoseStringValue for how much a dose of medication is.
Medications.MedicationList.DoseUnitStringUnits dosage is measured in.
Medications.MedicationList.RouteStringThe route by which the medication should be taken.
Medications.MedicationList.FrequencyStringThe frequency at which the medication may be taken.
Medications.MedicationList.DateStartedDateTimeThe date and time the medication was prescribed.
Medications.MedicationList.StatusStringStatus of the medication.
Medications.MedicationList.QuantityIntThe quantity of doses prescribed.
Medications.MedicationList.RefillsIntThe quantity of refills prescribed.
Medications.MedicationList.SubstitutionPermittedBooleanWhether or not substitutions are allowed.
Medications.MedicationList.PatientNotesStringNotes for patient's subscription.
Medications.MedicationList.OtherNotesStringGeneral notes for subscription.
Medications.MedicationList.StopReasonStringReason medication was stopped.
Medications.MedicationList.DateStoppedDateTimeDate and time medication was stopped.
Medications.MedicationList.PrescriptionIDStringPrescription ID.
Medications.MedicationList.FormString
Medications.MedicationList.IsSupplyBoolean
Medications.MedicationList.IsCompoundBoolean
Medications.MedicationList.NDCStringNDC code.
Medications.MedicationList.DaysSupplyIntQuantity of days supply for the subscription.
Medications.MedicationList.ProviderIDIntSubscribing provider's ID.
Medications.MedicationList.SourceString
Medications.MedicationList.DoseOtherString

MedicationAllergies ​

FieldData TypeComments
MedicationAllergiesMedicationAllergiesMedication allergies category wrapper.
MedicationAllergies.MedicationAllergyListArrayList of MedicationAllergies objects.
MedicationAllergies.MedicationAllergyList.SNOMEDStringSNWOMED code for allergy.
MedicationAllergies.MedicationAllergyList.AllergyStringDescription of allergy.
MedicationAllergies.MedicationAllergyList.ReactionStringAllergic reaction description.
MedicationAllergies.MedicationAllergyList.AdverseEventDateDateTimeDate and time of recorded adverse reaction.
MedicationAllergies.MedicationAllergyList.ExternalIDIntExternal ID for allergic reaction.
MedicationAllergies.MedicationAllergyList.StatusStringStatus of patient allergy.
MedicationAllergies.MedicationAllergyList.RxNormCodeStringRX Norm database code.
MedicationAllergies.MedicationAllergyList.SourceStringOriginating source description.
MedicationAllergies.MedicationAllergyList.SourceDateStringString form of date provided by originating source.
MedicationAllergies.MedicationAllergyList.AuthorString
MedicationAllergies.MedicationAllergyList.LastModifiedDateDateTimeDate allergy record was last modified in GEHRIMED.
MedicationAllergies.MedicationAllergyList.DataSourceString
MedicationAllergies.MedicationAllergyList.NDFRTCodeStringNDFRT code for allergy.
MedicationAllergies.MedicationAllergyList.AllergyTypeStringType of allergy.
MedicationAllergies.MedicationAllergyList.CategoryStringCategory of allergy.
MedicationAllergies.MedicationAllergyList.SeverityStringSeverity of allergy.
MedicationAllergies.MedicationAllergyList.NoteStringNotes about allergy.
MedicationAllergies.MedicationAllergyList.TTYString
MedicationAllergies.MedicationAllergyList.NDCStringNDC code for allergy.
MedicationAllergies.MedicationAllergyList.ExternalAllergyIDStringExternal ID for allergy.

Immunizations ​

FieldData TypeComments
ImmunizationsImmunizationsImmunizations category wrapper.
Immunizations.ImmunizationListArrayList of Immunization objects.
Immunizations.ImmunizationList.VaccineNameStringImmunization vaccine name.
Immunizations.ImmunizationList.DateOfServiceDateTimeDate and time immunization was given.
Immunizations.ImmunizationList.AdministeredAmountStringAmount administered for immunization.
Immunizations.ImmunizationList.AdministeredUnitsStringUnits administered for immunization.
Immunizations.ImmunizationList.VaccineLotNumStringImmunization vaccine lot number.
Immunizations.ImmunizationList.ManufacturerNameStringImmunization manufacturer name.
Immunizations.ImmunizationList.ManufacturerCodeStringImmunization manufacturer code.
Immunizations.ImmunizationList.NotesStringImmunization notes.
Immunizations.ImmunizationList.VaccineExpirationDateDateTimeImmunization vaccine expiration date and time.
Immunizations.ImmunizationList.AdministeredSiteStringSite where immunization was administered.
Immunizations.ImmunizationList.AdministeredRouteStringRoute by which immunization was administered.
Immunizations.ImmunizationList.ImmunizationDateDateTimeImmunization date and time.
Immunizations.ImmunizationList.CVXStringImmunization CVX code.
Immunizations.ImmunizationList.IISCodeStringImmunization IIS code.
Immunizations.ImmunizationList.RefusalReasonLongReason immunization was refused.
Immunizations.ImmunizationList.RegistryStatusString
Immunizations.ImmunizationList.RegistryStatusEffectiveDateDateTime
Immunizations.ImmunizationList.PublicityCodeString
Immunizations.ImmunizationList.PublicityCodeEffectiveDateDateTime
Immunizations.ImmunizationList.ProtectionIndicatorString
Immunizations.ImmunizationList.ProtectionIndicatorEffectiveDateDateTime
Immunizations.ImmunizationList.ProcessStatusInt
Immunizations.ImmunizationList.EnteredByNameStringName of who entered order for immunization.
Immunizations.ImmunizationList.OrderedByNameStringName of who ordered immunization.
Immunizations.ImmunizationList.AdministeredByNameStringName of who administered immunization.
Immunizations.ImmunizationList.ReadOnlyBoolean
Immunizations.ImmunizationList.StatusString

ImplantableDevices ​

FieldData TypeComments
ImplantableDevicesImplantableDevicesImplantable devices category wrapper.
ImplantableDevices.ImplantableDeviceListImplantableDeviceListImplantable device data records wrapper.
ImplantableDevices.ImplantableDeviceList.UDIStringUnique Device Identifier for device.
ImplantableDevices.ImplantableDeviceList.DescriptionStringDevice description.
ImplantableDevices.ImplantableDeviceList.BrandNameStringDevice brand.
ImplantableDevices.ImplantableDeviceList.VersionModelNumberStringDevice version model number.
ImplantableDevices.ImplantableDeviceList.CompanyNameStringDevice company name.
ImplantableDevices.ImplantableDeviceList.MRISafetyStatusStringSafety status for device being present during MRI.
ImplantableDevices.ImplantableDeviceList.LabeledContainsNRLString
ImplantableDevices.ImplantableDeviceList.LotNumberStringDevice lot number
ImplantableDevices.ImplantableDeviceList.SerialNumberStringDevice serial number.
ImplantableDevices.ImplantableDeviceList.ExpirationDateStringDate and time device expires.
ImplantableDevices.ImplantableDeviceList.ManufacturedDateStringDate and time device was manufactured.
ImplantableDevices.ImplantableDeviceList.DeviceIdentifierStringIdentifier for the device.
ImplantableDevices.ImplantableDeviceList.DonationIDString
ImplantableDevices.ImplantableDeviceList.IsActiveBooleanValue for whether or not the device is active.
ImplantableDevices.ImplantableDeviceList.InactiveReasonStringReason for the device being inactive.

Procedures ​

FieldData TypeComments
ProceduresProceduresProcedures category wrapper.
Procedures.ProcedureListProcedureListProcedure data wrapper.
Procedures.ProcedureList.DateOfServiceDateTimeDate and time of procedure.
Procedures.ProcedureList.ProcedureCodeStringProcedure code.
Procedures.ProcedureList.DescriptionStringDescription of procedure.
Procedures.ProcedureList.CommentStringProcedure comments provided.
Procedures.ProcedureList.StatusIntStatus of procedure.
Procedures.ProcedureList.NegationReasonLongReason code for negation of procedure.
Procedures.ProcedureList.NegationReasonTextStringText for negation of procedure.
Procedures.ProcedureList.LastModifiedByIntID of last provider who modified procedure record.

LabOrders ​

FieldData TypeComments
LabOrdersLabOrdersLabOrders category wrapper.
LabOrders.LabOrderListArrayList of LabOrder objects;
LabOrders.LabOrderList.PlacerOrderNumberString
LabOrders.LabOrderList.FillerOrderNumberString
LabOrders.LabOrderList.RequestedDateDateTimeDate order was requested.
LabOrders.LabOrderList.ObservationStartDateDateTimeDate observation for order began.
LabOrders.LabOrderList.ObservationEndDateDateTimeDate observation for order ended.
LabOrders.LabOrderList.SpecimenReceivedDateDateTimeDate order specimen was received.
LabOrders.LabOrderList.ScheduledDateDateTimeDate order was scheduled for.
LabOrders.LabOrderList.ServiceCodeString
LabOrders.LabOrderList.ServiceCodeTextString
LabOrders.LabOrderList.ServiceCodeSystemString
LabOrders.LabOrderList.SpecimenSourceStringSource of lab specimen for order.
LabOrders.LabOrderList.ResultStatusStringStatus for results of order.
LabOrders.LabOrderList.ResultForStudyCodeString
LabOrders.LabOrderList.ResultForStudyTextString
LabOrders.LabOrderList.ResultForStudyCodingSystemString
LabOrders.LabOrderList.ServiceTypeString
LabOrders.LabOrderList.TransactionDateDateTimeTransaction date for order.
LabOrders.LabOrderList.EnteredByIDStringID of who entered order.
LabOrders.LabOrderList.EnteredByFirstStringFirst of who entered order.
LabOrders.LabOrderList.EnteredByLastStringLast of who entered order.
LabOrders.LabOrderList.EnteredByDegreeStringDegree of who entered order.
LabOrders.LabOrderList.OrderingProviderIDStringProvider who ordered ID.
LabOrders.LabOrderList.OrderingProviderFirstStringProvider who ordered first name.
LabOrders.LabOrderList.OrderingProviderLastStringProvider who ordered last name.
LabOrders.LabOrderList.OrderingProviderDegreeStringProvider who ordered degree.
LabOrders.LabOrderList.OrderingProviderIDTypeStringProvider who ordered ID type.
LabOrders.LabOrderList.OrderingProviderAssigningAuthorityStringProvider who ordered assigning authority.
LabOrders.LabOrderList.SourceString
LabOrders.LabOrderList.VersionString
LabOrders.LabOrderList.RequestedByInt
LabOrders.LabOrderList.StatusCodeInt
LabOrders.LabOrderList.EncounterIDIntID for encounter on which order was placed.
LabOrders.LabOrderList.NotesStringOrder notes.
LabOrders.LabOrderList.UserNotesStringUser notes for order.
LabOrders.LabOrderList.LabResultArrayList of LabResult objects.

LabResult ​

FieldData TypeComments
LabResultLabResultLabResult category data wrapper.
LabResult.ValueTypeString
LabResult.ObservationCodeString
LabResult.ObservationCodeTextString
LabResult.ObservationCodeSystemString
LabResult.ObservationValueStringValue observed for lab test.
LabResult.ObservationUnitsStringUnits value is in.
LabResult.ObservationUnitsTextStringText for value units.
LabResult.ObservationUnitsCodeSystemStringCode system used for units.
LabResult.ObservationReferenceRangeString
LabResult.AbnormalFlagsString
LabResult.ResultStatusStringStatus of lab result.
LabResult.ObservationDateDateTimeDate lab result was processed.
LabResult.ResponsibleObserverIDStringID for party responsible for making observation.
LabResult.ObservationMethodCodeString
LabResult.ObservationMethodCodeTextString
LabResult.ObservationMethodCodeSystemString
LabResult.ProducerIDString
LabResult.PerformingOrganizationIDString
LabResult.PerformingOrganizationNameString
LabResult.PerformingOrganizationAssigningAuthorityString
LabResult.PerformingOrganizationAddressString
LabResult.PerformingOrganizationOtherString
LabResult.PerformingOrganizationCityString
LabResult.PerformingOrganizationStateString
LabResult.PerformingOrganizationZipString
LabResult.PerformingOrganizationStateString
LabResult.StatusCodeInt
LabResult.NotesString
LabResult.UserNotesString

Vitals ​

FieldData TypeComments
VitalsVitalsVitals category wrapper.
Vitals.VitalsListArrayList of Vital objects.
Vitals.VitalsList.NameStringThe type of vital sign being represented.
Vitals.VitalsList.LOINCStringLOINC code.
Vitals.VitalsList.DataStringThe value of the vital sign.
Vitals.VitalsList.AdditionalDataStringAny supplementary data that was specified in the entry.
Vitals.VitalsList.DateEnteredDateTimeDate and Time the vital entry was recorded.

History Type Data ​

Categories include CareTeam, TreatmentPlan, Assessment, Goals, and HealthConcerns. They are represented as follows, except with the actual category listed instead of "Category".Field.

FieldData TypeComments
Category.HistoryTypeStringDescribes the type of history item being represented by the data in the proceeding History field.
Category.HistoryStringThe current value for the type of data described in the HistoryType field.

Last updated:

Access to this API requires prior authorization.