MDCare API

Application Access - WEB API: Below API methods publicly accessible with trusted authentication to identify a patient and/or access Information related to a specific patient with in a secure session.


Token

  • Method Name: "Token"
  • Description: To Get Patient's Token Based on given input data. Token would expire after session Time over.
  • Parameters:
    1. First Name (Patient’s First name)
    2. Last Name (Patient’s Last name)
    3. Secret key (Issued to Patient at the time of registration)
    4. Mrno (Patient’s Medical Record Number)
    5. Username (Requester Name)
    6. User Email (Requester email)
    7. User Phone (Requester Phone)
  • Required Parameters: Username, User Email, User Phone, Secret Key for capturing requester details.
  • Optional parameters: Either Mrno or First & Last name of patient.
  • Success Response: Returns a String in XML format, containing a random value called "token"
<user>
<token>xnChEfP11EhWAOqF9srPRZX7lcevrOCkTURDYXJlNzQ0ODI=</token>
<ExpireTimeInMinutes>15</ExpireTimeInMinutes>
</user>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid Credentials
    2. Unkown Error
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0/api/token?UserName=abcd&UserEmail=abc@xyz.com&UserPhone=111-111-1111&secretkey=N^VK8H987098MDCare&Mrno=74482

Patient Name

  • Method Name: "PatientName"
  • Description: To Get Patient's Name
  • Parameters: Token.
  • Required Parameters: Token : Alphanumeric value which is used to identify patient.
  • Success Response: Returns a String in XML format, containing name of the patient.
<PatientName>
<prefix />
<given>Alice</given>
<family>NewmanSample</family>
<suffix />
</PatientName>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0 /api/PatientName? Token=xxxxxxxxxxxxxxxxxxxxxxxxx

Sex

  • Method Name: "Gender"
  • Description: To Get Patient's Gender
  • Parameters: Token
  • Required Parameters: Token: Alphanumeric value which is used to identify patient.
  • Success Response: Returns a String in XML format, containing Gender of the patient.
<PatientInfo>
<sex>Female</sex>
</PatientInfo>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token.
    2. Token session Expired
  • SampleCall: https://demo.mdcare.com/MDcareapiv5.0 /api/Gender? Token=xxxxxxxxxxxxxxxxxx

Date of birth

  • Method Name: "DateOfBirth"
  • Description: To Get Patient's DOB
  • Parameters: Token
  • Required: Token: Alphanumeric value which is used to identify patient.
  • Optional: Any of the above 2 parameters is mandatory
  • Success Response: Returns a String in XML format, containing DOB of the patient.
<PatientInfo>
<DateOfBirth>19880121</DateOfBirth>
</PatientInfo>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0/api/DateOfBirth?Token=Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Race

  • Method Name: "Race"
  • Description: To Get Patient's Race(s)
  • Parameters: Token
  • Required Parameters: Token: Alphanumeric value which is used to identify patient.
  • Success Response: Returns a String in XML format, containing Race(s) of the patient.
<PatientInfo>
<RACE>
<DisplayName>White</DisplayName>
<Code>2106-3</Code>
<Code_SystemName>CDC-RACE</Code_SystemName>
<Code_system>2.16.840.1.113883.6.238</Code_system>
</RACE>
</PatientInfo>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0/api/Race?Token=Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • Notes: It is possible to document more than one race, if in such a case, XML string should carry all the races documented in the s/w.

Ethnicity

  • Method Name: "Ethnicity"
  • Description: To Get Patient's Ethnicity
  • Parameters: Token
  • Required Parameters: Token: Alphanumeric value which is used to identify patient.
  • Success Response: Returns a String in XML format, containing Ethnicity of the patient.
<PatientInfo>
<Ethnicity>
<DisplayName>Hispanic or Latino</DisplayName>
<Code>2135-2</Code>
<Code_SystemName>CDC -Ethnicity</Code_SystemName
<Code_system>2.16.840.1.113883.6.238</Code_system>
</Ethnicity>
</PatientInfo>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0/api/Ethnicity?Token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Preferred Language

  • Method Name: "Preferred_Language"
  • Description: To Get Patient's Preferred-Language(s)
  • Parameters: Token
  • Required: Token: alphanumerical value which used to identify patient
  • Success Response: Returns a String in XML format, containing Preferred-Language(s) of the patient.
<PatientInfo>
<PatientInfo>
<languages>
<DisplayName>English</DisplayName>
<Code>en</Code>
<Code_systemName>LanguageAbilityMode</Code_systemName>
<Code_system>2.16.840.1.113883.5.60</Code_system>
</languages>
<PatientInfo>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
  • SampleCall: https://demo.mdcare.com/MDcareapiv5.0/api/Preferred_Language?Token=Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate =06/22/2015
  • Notes: It is possible to document more than one preferred language, if in such a case, XML string should carry all the items documented in the s/w.

Smoking Status

  • Method Name: "Smoking_Status"
  • Description: To Get Patient's Smoking-Status
  • Parameters: Token
    1. FromDate - DateTime
    2. FromDate - DateTime
    3. ToDate - DateTime
  • Required : Token: Alphanumeric value which is used to identify patient.FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing Smoking Status of the patient
<SocialHistory>
<SmokingStatus>
<SNOMED_CT>449868002</SNOMED_CT>
<Smoking_Status>Current every day smoker</Smoking_Status>
<Start_Date>20150622</Start_Date>
</SmokingStatus>
</SocialHistory>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No data found
    4. unknown error
  • SampleCall: https://demo.mdcare.com/MDcareapiv5.0/api/Smoking_Status?Token=xxxxxxxxxxxxxxxxxxxxxxx&FromDate=08/01/2017&ToDate=08/31/2017

Problems

  • Method Name: "Problems"
  • Description: To Get Patient's Problems List of Visits that occurred between or on given date range or date .
  • Parameters:
    1. Token
    2. FromDate – DateTime
    3. ToDate - DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • From Date is required parameter.
  • Optional: To date: is optional parameter
  • Success Response: Returns a String in XML format, containing Problems of the patient
<problems>
<problem>
<Problem>Obesity, unspecified</Problem>
<problemcode>238131007</problemcode>
<Date>20061231</Date>
<EndDate>06/01/2007</EndDate>
<Status>completed</Status>
<CodeSystemName>SNOMED-CT</CodeSystemName>
<Code_System>2.16.840.1.113883.6.96</Code_System>
</problem>
<problem>
<Problem>Essential (primary) hypertension</Problem>
<problemcode>59621000</problemcode>
<Date>20111005</Date>
<EndDate></EndDate>
<Status>Active</Status>
<CodeSystemName>SNOMED-CT</CodeSystemName>
<Code_System>2.16.840.1.113883.6.96</Code_System>
</problem>
</problems>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token.
    2. Token session Expired.
    3. No Data Found
    4. UnKown Error
  • SampleCall: https://demo.mdcare.com/MDcareapiv5.0/api/Problems?Token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=&ToDate=08/09/2017

Medications

  • Method Name: "Medications"
  • Description: To Get Patient's Medications
  • Parameters:
    1. Token
    2. FromDate – DateTime
    3. ToDate - DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing Medications of the patient
<Medications>
<Medication>
<Medication_Name>Tylenol Extra Strength 500 MG Oral Tablet</Medication_Name>
<Rxnormcode>209459</Rxnormcode>
<Composition>ACETAMINOPHEN</Composition>
<StartDate>20150622</StartDate>
<EndDate>20150701</EndDate>
<Quantity>10</Quantity>
<Dose>1</Dose>
<DoseName>Unit</DoseName>
<InstructionText> for 10 days</InstructionText>
<RouteValue>ORALLY</RouteValue>
<Frequency>as needed</Frequency>
<Status>Inactive</Status>
<Statuscode>code="73425007"</Statuscode>
<Order_Quantity>10</Order_Quantity>
<Performer_Prefix>Dr.</Performer_Prefix>
<performer_GivenName>Davis Albert</performer_GivenName>
<performer_FamilyName></performer_FamilyName>
</Medication>
<Medication>
<Medication_Name>cefTRIAXone 100 MG/ML Injectable Solution</Medication_Name>
<Rxnormcode>309090</Rxnormcode>
<Composition>CEFTRIAXONE</Composition>
<StartDate>20150622</StartDate>
<EndDate>20150630</EndDate>
<Quantity>1</Quantity>
<Dose>1</Dose>
<DoseName>Unit</DoseName>
<InstructionText> for 9 days</InstructionText>
<RouteValue>INTRAVENOUSLY</RouteValue>
<Frequency>twice a day</Frequency>
<Status>Inactive</Status>
<Statuscode>code="73425007"</Statuscode>
<Order_Quantity>1</Order_Quantity>
<Performer_Prefix>Dr.</Performer_Prefix>
<performer_GivenName>Davis Albert</performer_GivenName>
<performer_FamilyName></performer_FamilyName>
</Medication>
<Medication>
<Medication_Name>Aranesp 500 MCG in 1 ML Prefilled Syringe</Medication_Name>
<Rxnormcode>731241</Rxnormcode>
<Composition>DARBEPOETIN ALFA</Composition>
<StartDate>20150622</StartDate>
<EndDate></EndDate>
<Quantity>0</Quantity>
<Dose>1</Dose>
<DoseName>Unit</DoseName>
<InstructionText> for days</InstructionText>
<RouteValue>INTRAVENOUSLY</RouteValue>
<Frequency>once a week</Frequency>
<Status>Active</Status>
<Statuscode>code="55561003"</Statuscode>
<Order_Quantity>0</Order_Quantity>
<Performer_Prefix>Dr.</Performer_Prefix>
<performer_GivenName>Davis Albert</performer_GivenName>
<performer_FamilyName></performer_FamilyName>
</Medication>
</Medications>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0 /api/Medications? Token=xxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/06/2017&ToDate=06/22/2017

Medication Allergies

  • Method Name: "Medication_Allergies"
  • Description: To Get Patient's Medication-Allergies
  • Parameters:
    1. Token
    2. FromDate – DateTime
    3. ToDate - DateTime
  • Required: Token: Alphanumeric value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing Medication Allergies of the patient
<ALL>
<Allergies>
<allergy>PENICILLIN G</allergy>
<NDCcode>720001</NDCcode>
<RxNorm>7980</RxNorm>
<AllergyRecordedDate>20170915</AllergyRecordedDate>
<TimingInformation>19800510</TimingInformation>
<Status>Active</Status>
<StatusCode></StatusCode>
<SeverityName>Moderate</SeverityName>
<SeverityCode>6736007</SeverityCode>
<Reaction>
<Reaction_Name>Hives</Reaction_Name>
<Code>247472004</Code>
<CodeSystemName>SNOMED-CT</CodeSystemName>
<Code_System>2.16.840.1.113883.6.96</Code_System>
<Reaction_Severity>Moderate</Reaction_Severity>
</Reaction>
</Allergies>
<Allergies>
<allergy>AMPICILLIN</allergy>
<NDCcode>720101</NDCcode>
<RxNorm>733</RxNorm>
<AllergyRecordedDate>20170915</AllergyRecordedDate>
<TimingInformation>19800510</TimingInformation>
<Status>Active</Status>
<StatusCode></StatusCode>
<SeverityName>Moderate</SeverityName>
<SeverityCode>6736007</SeverityCode>
<Reaction>
<Reaction_Name>Hives</Reaction_Name>
<Code>247472004</Code>
<CodeSystemName>SNOMED-CT</CodeSystemName>
<Code_System>2.16.840.1.113883.6.96</Code_System>
<Reaction_Severity>Moderate</Reaction_Severity>
</Reaction>
</Allergies>
</ALL>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • SampleCall: https://demo.mdcare.com/MDcareapiv5.0/api/Medication_Allergies?Token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/06/2017&ToDate=06/22/2017

Laboratory Tests

  • Method Name: "LabTest"
  • Description: To Get Patient's Laboratory Tests
  • Parameters :
    1. Token
    2. FromDate – DateTime
    3. ToDate - DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns  a String in XML format , containing Laboratory Tests of the patient
<Labs>
<LabTest>
<TestName>Urinanalysis macro (dipstick) pane</TestName>
<SNOMEDCT></SNOMEDCT>
<CPTCode>81007</CPTCode>
<Date>20150622</Date>
<Performer_GivenName>Davis Albert</Performer_GivenName>
<Performer_FamilyName></Performer_FamilyName>
<Performer_Streetname>2472, Rocky place </Performer_Streetname>
<Performer_City>Beaverton</Performer_City>
<Performer_State>OR</Performer_State>
<Performer_Country>USA</Performer_Country>
<Performer_PostalCode>97006</Performer_PostalCode>
</LabTest>
<LabTest>
<TestName>Urinanalysis macro (dipstick) panel</TestName>
<SNOMEDCT></SNOMEDCT>
<CPTCode>50010</CPTCode>
<Date>20150622</Date>
<Performer_GivenName>Davis Albert</Performer_GivenName>
<Performer_FamilyName></Performer_FamilyName>
<Performer_Streetname>2472, Rocky place </Performer_Streetname>
<Performer_City>Beaverton</Performer_City>
<Performer_State>OR</Performer_State>
<Performer_Country>USA</Performer_Country>
<Performer_PostalCode>97006</Performer_PostalCode>
</LabTest>
</Labs>
</Lab>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0 /api/LabTest?Token= xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/01/2017&ToDate=30/06/2017

Laboratory Value(s)/ Result(s)

  • Method Name: "Laboratory_Result"
  • Description: To Get Patient's Laboratory-Values-Results
  • Parameters:
    1. Token
    2. FromDate - DateTime
    3. ToDate – DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing Laboratory-Value(s)-Result(s) of the patient
<LabResults>
<LabTest>
<LOINC_Code>24357-6</LOINC_Code>
<Test>Urinanalysis macro (dipstick) pane</Test>
<TestDate>20150622</TestDate>
<TestResult>
<Loinc_Code>5767-9</Loinc_Code>
<Result>Appearance of Urine</Result>
<Values>1</Values>
<Units>-</Units>
<PerformedDate>20150622</PerformedDate>
<ObservationRange> CLEAR</ObservationRange>
</TestResult>
</LabTest>
<LabTest>
<LOINC_Code>24357-6</LOINC_Code>
<Test>Urinanalysis macro (dipstick) panel</Test>
<TestDate>20150622</TestDate>
<TestResult>
<Loinc_Code>5778-6</Loinc_Code>
<Result>Color of Urine</Result>
<Values>1</Values>
<Units>-</Units>
<PerformedDate>20150622</PerformedDate>
<ObservationRange>Yellow YELLOW</ObservationRange>
</TestResult>
</LabTest>
</LabResults>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • SampleCall: https://demo.mdcare.com/MDcareapiv5.0/api/Laboratory_Result?Token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/01/2017&ToDate=30/06/2017

Vital Signs

  • Method Name: "Vital_Signs "
  • Description: To Get Patient's Vital-Signs
  • Parameters:
    1. Token
    2. FromDate – DateTime
    3. ToDate – DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format , containing Vital Signs of the patient.
<Vital_Signs>
<Height_Code>8302-2</Height_Code>
<height_value>168</height_value>
<height_Units>cm</height_Units>
<Weight_Code>29463-7</Weight_Code>
<Weight_Value>82</Weight_Value>
<Weight_Units>kg</Weight_Units>
<Blood_Pressure_Diastolic_Code>8462-4</Blood_Pressure_Diastolic_Code>
<Blood_Pressure_Diastolic_Value></Blood_Pressure_Diastolic_Value>
<Blood_Pressure_Diastolic_Units>mm[Hg]</Blood_Pressure_Diastolic_Units>
<Blood_Pressure-Systolic_Code>8480-6</Blood_Pressure-Systolic_Code>
<Blood_Pressure-Systolic_Value></Blood_Pressure-Systolic_Value>
<Blood_Pressure-Systolic_Units>  mm[Hg]</Blood_Pressure-Systolic_Units>
<Heart_Rate_Code>8867-4</Heart_Rate_Code>
<Heart_Rate_Value></Heart_Rate_Value>
<Heart_Rate_Units>/min</Heart_Rate_Units>
<O2_Percentage_BldC_Oximetry_Code>59408-5</O2_Percentage_BldC_Oximetry_Code>
<O2_Percentage_BldC_Oximetry_Value></O2_Percentage_BldC_Oximetry_Value>
<O2_Percentage_BldC_Oximetry_Units>%</O2_Percentage_BldC_Oximetry_Units>
<Body_Temperature_Code>8310-5</Body_Temperature_Code>
<Body_Temperature_Value>-17</Body_Temperature_Value>
<Body_Temperature_Units> Cel</Body_Temperature_Units>
<Respiratory_Rate_Code>9279-1</Respiratory_Rate_Code>
<Respiratory_Rate_value></Respiratory_Rate_value>
<Respiratory_Rate_Units>/min</Respiratory_Rate_Units>
<Inhaled_oxygen_concentration_Code>3150-0</Inhaled_oxygen_concentration_Code>
<Inhaled_oxygen_concentration_Value></Inhaled_oxygen_concentration_Value>
<Inhaled_oxygen_concentration_Units>%</Inhaled_oxygen_concentration_Units>
<BMIValue>29.0</BMIValue>
<Timing_info>2017-09-07T10:15:25.283</Timing_info>
<Code_SystemName>LOINC</Code_SystemName>
<Code_System>2.16.840.1.113883.6.1</Code_System>
</Vital_Signs>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0 /api/Vital_Signs?Token= Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/01/2017&ToDate=30/06/2017

Procedures

  • Method Name: "procedures"
  • Description: To Get Patient's Procedures
  • Parameters:
    1. Token
    2. FromDate - DateTime
    3. ToDate - DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing Procedures of the patient.
<Procedures>
<Procedure>
<proc_name>Urinanalysis macro (dipstick) panel</proc_name>
<Date>20150622</Date>
<SNOMEDCT></SNOMEDCT>
<Snomed_Name></Snomed_Name>
<Status>Active</Status>
<TargetsiteSnomedCode></TargetsiteSnomedCode>
<TargetsiteSnomedName></TargetsiteSnomedName>
<ServiceDeliveryLocation>Neighborhood Physicians Practice, 2472, Rocky Place, Beaverton, OR 97006</ServiceDeliveryLocation>
<AssignedEntity_street>2472, Rocky Place </AssignedEntity_street>
<AssignedEntity_city>Beaverton</AssignedEntity_city>
<AssignedEntity_state>OR</AssignedEntity_state>
<AssignedEntity_postal>97006</AssignedEntity_postal>
<AssignedEntity_country>USA</AssignedEntity_country>
</Procedure>
</Procedures>
  • Error Response:   Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0 /api/procedures?Token=Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/01/2017&ToDate=30/06/2017

Care Team Member(s)

  • Method Name: "CareTeamMembers"
  • Description: To Get Patient's Care-Team-Members
  • Parameters:
    1. Token
    2. FromDate - DateTime
    3. ToDate – DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing Care-Team-Members of the patient.
<CareTeamMembers>
<CareTeamMember>
<performerstarttime>2016-06-06T12:25:00</performerstarttime>
<performerendtime>2016-06-06T12:25:00</performerendtime>
<Performergiven>Benjamin</Performergiven>
<PerformerFamily>Frank</PerformerFamily>
<PerformerPrefix></PerformerPrefix>
<PerformerAddress></PerformerAddress>
<PerformerCity></PerformerCity>
<PerformerState></PerformerState>
<PerformerPostalCode></PerformerPostalCode>
<PerformerCountry></PerformerCountry>
<performerCode>NA</performerCode>
<performertelecom> tel=</performertelecom>
</CareTeamMember>
<CareTeamMember>
<performerstarttime>2016-06-06T12:25:00</performerstarttime>
<performerendtime>2016-06-06T12:25:00</performerendtime>
<Performergiven>Albert</Performergiven>
<PerformerFamily>Davis</PerformerFamily>
<PerformerPrefix></PerformerPrefix>
<PerformerAddress></PerformerAddress>
<PerformerCity></PerformerCity>
<PerformerState></PerformerState>
<PerformerPostalCode></PerformerPostalCode>
<PerformerCountry></PerformerCountry>
<performerCode>RP</performerCode>
<performertelecom> tel=</performertelecom>
</CareTeamMember>
</CareTeamMembers>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0/api/CareTeamMembers?Token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/01/2017&ToDate=30/06/2017

Immunizations

  • Method Name: "Immunizations"
  • Description: To Get Patient's Immunizations
  • Parameters:
    1. Token
    2. FromDate - DateTime
    3. ToDate – DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing Immunizations of the patient.
<Immunizations>
<Immunization>
<Vaccene_Name>DTaP, 5 pertussis antigens</Vaccene_Name>
<Immunization_Code>106</Immunization_Code>
<CodeSystem>CVX</CodeSystem>
<Code_System>2.16.840.1.113883.12.292</Code_System>
<Date>20120104</Date>
<Immunization>DAPTACEL vaccine 0.5 ML Injection</Immunization>
<Route></Route>
<DoseValue></DoseValue>
<Lot_Number>2</Lot_Number>
<Manufacture_Name>Immuno-U.S., Inc.</Manufacture_Name>
<Notes></Notes>
<RefuseReason></RefuseReason>
<Status>Completed</Status>
<Performer_GivenName>Davis Albert</Performer_GivenName>
<Performer_FamilyName></Performer_FamilyName>
<Performer_Streetname>2472, Rocky Place </Performer_Streetname>
<Performer_City>Beaverton</Performer_City>
<Performer_State>OR</Performer_State>
<Performer_Country>USA</Performer_Country>
<Performer_PostalCode>97006</Performer_PostalCode>
</Immunization>
<Immunization>
<Vaccene_Name>influenza, intradermal, quadrivalent, preservative free</Vaccene_Name>
<Immunization_Code>166</Immunization_Code>
<CodeSystem>CVX</CodeSystem>
<Code_System>2.16.840.1.113883.12.292</Code_System>
<Date>20170917</Date>
<Immunization>influenza, intradermal, quadrivalent, preservative free</Immunization>
<Route></Route>
<DoseValue></DoseValue>
<Lot_Number></Lot_Number>
<Manufacture_Name />
<Notes>Immunization was not given-Patient rejected immunization</Notes>
<RefuseReason>Patient objection</RefuseReason>
<Status>Cancelled</Status>
<Performer_GivenName>Davis Albert</Performer_GivenName>
<Performer_FamilyName></Performer_FamilyName>
<Performer_Streetname>2472, Rocky Place </Performer_Streetname>
<Performer_City>Beaverton</Performer_City>
<Performer_State>OR</Performer_State>
<Performer_Country>USA</Performer_Country>
<Performer_PostalCode>97006</Performer_PostalCode>
</Immunization>
</Immunizations>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0/api/Immunizations?Token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/01/2017&ToDate=06/30/2017

UDI Implants

  • Method Name: "UDIImplants"
  • Description: To Get Patient's UDI-Implants-List
  • Parameters:
    1. Token
    2. FromDate - DateTime
    3. ToDate – DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing UDI-Implants-List of the patient.
<UDI>
<IMPLANTS>
<Procedure>Introduction to cardiac pacemaker system via vein</Procedure>
<Implanted>Viva™ Quad XT CRT-D</Implanted>
<Area>704707009 - Cardiac resynchronization therapy implantable defibrillator (physical object)</Area>
<UDI>(01)00643169007222(17)160128(21)BLC200461H</UDI>
<Model>DTBA1QQ</Model>
<Serial_Number>BLC200461H</Serial_Number>
<Lot_Number></Lot_Number>
<EffectiveDate>20111005</EffectiveDate>
<UDISnomedcode>Code:704707009</UDISnomedcode>
<TargetSiteCodeSnomed>Code:9454009</TargetSiteCodeSnomed>
<AssigningAuthority>FDA</AssigningAuthority>
<performer_street>2472, Rocky Place </performer_street>
<performer_city>Beaverton</performer_city>
<performer_state>OR</performer_state>
<performer_postal>97006</performer_postal>
<performer_country>USA</performer_country>
<performer_phone></performer_phone>
</IMPLANTS>
</UDI>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • SampleCall: https://demo.mdcare.com/MDcareapiv5.0/api/UDIImplants?Token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=01/01/2017&ToDate=09/09/2017

Assessment And Plan Of Treatment

  • Method Name: "Assessment "
  • Description: To Get Patient's plan
  • Parameters:
    1. Token
    2. FromDate - DateTime
    3. ToDate – DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing plan of the patient.
<AssessmentAndPlanOfTreatment>
<Assessment>
<AssessmentUnstructuredText>Fever:
The patient was found to have fever and Dr Davis is suspecting Anemia based on the patient history. So Dr Davis asked the patient to closely monitor the temperature and blood pressure and get admitted to Community Health Hospitals if the fever does not subside within a day.</AssessmentUnstructuredText>
</Assessment>
<PlanOfTreatment>
<FuturePlannedCare>
<Plan>Dr.Albert   Davis 2472 Rocky Place Beaverton OR USA 97006 Scheduled on 07/01/2015</Plan>
<Date>20150701</Date>
<Instructions></Instructions>
<Code></Code>
<CodeSystem></CodeSystem>
<Participant_Name>Davis Albert </Participant_Name>
<Participant_Street>2472, Rocky Place  </Participant_Street>
<Participant_City>Beaverton</Participant_City>
<Participant_State>OR</Participant_State>
<Participant_Country>USA</Participant_Country>
<Participant_Postal>97006</Participant_Postal>
<Participant_Phone>555-555-1002</Participant_Phone>
</FuturePlannedCare>
<FuturePlannedCare>
<Plan>clindamycin HCl 300 MG Oral Capsule</Plan>
<Date></Date>
<Instructions>clindamycin HCl 300 MG Oral Capsule take three times a day as needed if pain does not subside.</Instructions>
<Code>284215</Code>
<CodeSystem>RXNorm</CodeSystem>
<Participant_Name>Davis Albert </Participant_Name>
<Participant_Street>2472, Rocky Place  </Participant_Street>
<Participant_City>Beaverton</Participant_City>
<Participant_State>OR</Participant_State>
<Participant_Country>USA</Participant_Country>
<Participant_Postal>97006</Participant_Postal>
<Participant_Phone>555-555-1002</Participant_Phone>
</FuturePlannedCare>
</PlanOfTreatment>
</AssessmentAndPlanOfTreatment>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0 /api/Assessment?Token= Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/01/2017&ToDate=06/30/2017

Goals

  • Method Name: "Goals"
  • Description: To Get Patient's Goals
  • Parameters:
    1. Token
    2. FromDate - DateTime
    3. ToDate – DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing Goals of the patient.
<Goals>
<Goal>
<Name>Salmonella Os (organism)</Name>
<Code>656008</Code>
<GoalValue></GoalValue>
<Effective_time>20170309</Effective_time>
<Status>Goal achieved</Status>
<Code_SystemName>SNOMED-CT</Code_SystemName>
<Code_System>2.16.840.1.113883.6.96</Code_System>
</Goal>
<Goal>
<Name>Get rid of intermittent fever that is occurring every few weeks.</Name>
<Code></Code>
<GoalValue></GoalValue>
<Effective_time>20170509</Effective_time>
<Status>Goal not achieved</Status>
<Code_SystemName>SNOMED-CT</Code_SystemName>
<Code_System>2.16.840.1.113883.6.96</Code_System>
</Goal>
</Goals>
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0 /api/Goals?Token= Xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/01/2017&ToDate=06/30/2017

Health Concerns

  • Method Name: "HealthConcerns"
  • Description: To Get Patient's Health-Concerns
  • Parameters:
    1. Token
    2. FromDate – DateTime
    3. ToDate – DateTime
  • Required: Token: alphanumerical value which is used to identify patient.
    • FromDate is required parameter.
  • Optional: To date is optional parameter
  • Success Response: Returns a String in XML format, containing Health Concerns of the patient
<HealthConcerns>
<HealthConcerns>
<HealthConcern>Keratolytic agent (product) </HealthConcern>
<HealthConcernCode>2871004</HealthConcernCode>
<Code_SystemName>SNOMED-CT</Code_SystemName>
<Code_System>2.16.840.1.113883.6.96</Code_System>
<Status>Active</Status>
<OnSetDate>20170904</OnSetDate>
</HealthConcerns>
</HealthConcerns>
  • Error Response: Returns anyof the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. No Data Found
    4. Unknown Error occurred
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0/api/HealthConcerns?Token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/01/2017&ToDate=06/30/2017

All Data Request

  • Method Name: "AllDataRequest"
  • Description: To Get Patient's Consoilidated CDA document in a Zip file
  • Parameters: Token, FromDate, ToDate
  • Required: Token: alphanumerical value which is used to identify patient. and required parameter.
  • Optional: FromDate & To date are optional parameter.
  • Success Response: Downloads a ZIP file which contains Consolidated CDA file.
  • Error Response: Returns any of the below error in case of failed attempt.
    1. Invalid token
    2. Token session Expired
    3. Unknown Error occurred
  • Sample Call: https://demo.mdcare.com/MDcareapiv5.0/api/AllDataRequest?Token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&FromDate=06/01/2017&ToDate=06/30/2017


Error Codes: All Methods of API returns an error response along with any of the below codes.

Code Description
301 Invalid ID  or Invalid token.
302 Token session Expired.
303 Invalid Credentials
305 No data found.
307 Unknown error occurred while processing request.
308 Enter a valid date (for example, mm/dd/yyyy).
309 Token Method call requires valid secret key
310 Token Method call requires either  MrNo (or) Last Name ,First name .
311 API Request is missing required parameters - 'Token', 'FromDate'.
312 API Request is missing required parameter - 'FromDate'.
313 API Request is missing required parameter - 'Token'.




© All Rights Reserved. MDCare EMR/PMS 2015