Get started

API Endpoint:
https://thp.medtel.in/clientintegration/Integration/

Request parameters: query parameters

Request method: POST

The MedTel API(s) provides programmatic access to register patient, get screening data, generate consultation, get prescription etc.

To use this API, you need an API key. Please contact us at ops@medtel.in to get your own API key.

Patient Registration


# Here is a curl example
curl --location --request POST 'https://thp.medtel.in/clientintegration/Integration/patientRegistration?access_token=d5844ff2823017053b652a88d5f70ecd&thp_id=a56fa72ac60e18b9778e26b95caae0af&patient_name=API Patient&mobile=1122334455&gender=Male&age=35&weight=160&height=165&session_token=P6F45&webhook_url=https://yourdomain.com/getScreeningData&preferred_poc_devices=["BLOOD_PRESSURE","HEMOGLOBIN","TEMPERATURE"]'

To start screening you need to make a POST call to the following url :
https://thp.medtel.in/clientintegration/Integration/patientRegistration


On Success :

{
    "code": 200,
    "errors": [],
    "status": "OK",
    "msg": "Success"
}

QUERY PARAMETERS

Field	Type	Description
access_token	String	(*)-Static id, provided by MedTel
thp_id	String	(*)-Static id, provided by MedTel
patient_name	String(50)	(*) Name of patient
mobile	String(50)	(*) Mobile number of patient 10 digit integers only
gender	String	(*) Gender of patient Male Female
age	Integer(3)	(*) Age of patient Range in 1 to 99
weight	Integer(3)	(optional) Weight of patient in KG Range in 1 to 150
height	Integer(3)	(optional) Height of patient in CM Range in 1 to 200
session_token	String(50)	(optional) Unique id of patient
webhook_url	String(255)	(optional) To get data in multiple server
preferred_poc_devices	String(255)	(optional) To show the selected devices

Get Screening Data

All screening data will be send by POST call to the following url :
pre defined webhook_url


Result example :

{
  "medteluniqueid": "367c2ac07d093044b0e10d5cc16fe7b1",
  "thp_id": "ccdb1adfc37b956e054b1deae7308aa1",
  "thp_name": "Gainhealth-Medtel",
  "name": "Arpita Sur",
  "mobile": "7205203593",
  "gender": "Female",
  "age": "27",
  "screening_date": "2022-03-01",
  "screening_time": "13:10",
  "patient_uniqueid": "dfsfdfd34342c34",
  "screening_details": [
    {
      "pocType": "Body Analyzer",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "ba_weight": "58.15",
        "ba_bmi": "21.4",
        "ba_body_fat": "24.2",
        "ba_fat_free_body_weight": "44.05",
        "ba_subcutaneous_fat": "22.6",
        "ba_visceral_fat": "4.0",
        "ba_body_water": "52.0",
        "ba_skeletal_muscle": "44.1",
        "ba_muscle_mass": "41.43",
        "ba_bone_mass": "2.64",
        "ba_protein": "18.06",
        "ba_bmr": "1322.0",
        "ba_bsa": "1.6"
      }
    },
    {
      "pocType": "Thermometer",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "thermometer": "98",
        "thermometer_unit": "°F"
      }
    },
    {
      "pocType": "SpO2",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "spo2": "99",
        "spo2_pulse": "73",
        "spo2_pi": "6"
      }
    },
    {
      "pocType": "Vitals_BP",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "bp": "103/83 mmHg",
        "pulse": "79"
      }
    },
    {
      "pocType": "FHR",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "trimester": "2",
        "bpm": "79",
        "duration": "4.45"
      }
    },
    {
      "pocType": "Stethoscope",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "stethoscope_type": "H",
        "stetho_path": [
          {
            "position": "Aortic",
            "path": "https://path.link"
          },
          {
            "position": "Pulmonic",
            "path": "https://path.link"
          },
          {
            "position": "Tricuspid",
            "path": "https://path.link"
          },
          {
            "position": "Mitral",
            "path": "https://path.link"
          }
        ]
      }
    },
    {
      "pocType": "Otoscope",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "otoscope_path": [
          "https://path.link",
          "https://path.link"
        ]
      }
    },
    {
      "pocType": "Sync",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "glucose": "107",
        "glucoseCategory": "Random"
      }
    },
    {
      "pocType": "Hemoglobin",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "hemoglobin": "11.2"
      }
    },
    {
      "pocType": "HbA1c",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "hba1c": "9.5"
      }
    },
    {
      "pocType": "Malaria",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "malaria": "N"
      }
    },
    {
      "pocType": "Pregnancy",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "pregnancy": "N"
      }
    },
    {
      "pocType": "Urinalysis",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "urine_protein": "N",
        "urine_glucose": "N"
      }
    },
    {
      "pocType": "Covid",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "covid": "N"
      }
    },
    {
      "pocType": "HIV",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "hiv": "N"
      }
    },
    {
      "pocType": "HBsAg",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "hbsag": "N"
      }
    },
    {
      "pocType": "HCV",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "hcv": "N"
      }
    },
    {
      "pocType": "Typhoid",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "typhoid": "N"
      }
    },
    {
      "pocType": "Fundoscopy",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "fundoscopy_path": "https://path.link"
      }
    },
    {
      "pocType": "Renal function",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "rft_uric_acid": "4.6",
		"rft_creatinine": "103",
        "rft_urea": "45"
      }
    },
    {
      "pocType": "ECG",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "url": "https://ecgreport.link"
      }
    },
    {
      "pocType": "Lipid_Profile",
      "pocDateTime":"2022-08-30 11:50:30",
      "pocResult": {
        "triglycerides": "50",
        "total_cholesterol": "100",
        "hdl_cholesterol": "25",
        "ldl": "65",
        "vldl": "10",
        "tc_hdl_ratio": "4"
      }
    }
  ],
  "report_url": "https://report.link"
}

Consultation


# Here is a curl example
curl --location --request POST 'https://thp.medtel.in/clientintegration/Integration/generateTeleConsultation?access_token=d5844ff2823017053b652a88d5f70ecd&thp_id=a56fa72ac60e18b9778e26b95caae0af&patient_name=Robot%20Dsuza&customer_name=Robot%20Dsuza&mobile=9853098530&gender=Male&age=40&month=null&email=robotdsuza%40gmail.com&address=303%2C%204th%20Lane%2C%20Indiranagar%2C%20Bengaluru&weight=53&chief_complain=Cold%20and%20Fever%20from%20last%203%20days&bloodpressure=112%2F72&pulse=79&temprature=100&fbs=null&ppbs=null&allergy=Y&allergy_details=lactose%20intolerance&disease_history=depression&cough=Y&diabetis=N&smoking=N&alcoholism=N'

To generate consultation you need to make a POST call to the following url :
https://thp.medtel.in/clientintegration/Integration/generateTeleConsultation


On Success :

{
    "code": 200,
    "status": "TRUE",
    "msg": "successfully inserted",
    "uniqueid": "ef4a9fc0876dbbb0ece9f7bdecaae6e5"
}

QUERY PARAMETERS

Field	Type	Description
access_token	String	(*)-Static id, provided by MedTel
thp_id	String	(*)-Static id, provided by MedTel
patient_name	String(50)	(*) Name of patient
customer_name	String(50)	(*) Gurdian of patient, for childrens
mobile	String(50)	(*) Mobile number of patient
gender	String	(*) Gender of patient Male Female
age	Integer(3)	(*) Age of patient
month	Integer(2)	(optional) if year less then 1
email	String(50)	(optional) email id of patient
address	String(200)	(optional) Address of patient
weight	Integer(3)	(optional) Weight of patient in KG
chief_complain	String(255)	(optional) Describes the symptoms that led a patient to seek medical care
bloodpressure	String(15)	(optional) Blood pressure(eg: 120/80)
pulse	Integer(3)	(optional) Pulse (eg: 77)
temprature	String(6)	(optional) Temperature (eg: 99.3)
fbs	Integer(3)	(optional) Fasting blood sugar (eg: 103)
ppbs	Integer(3)	(optional) Postprandial blood sugar (eg: 208)
allergy	Char(1)	(optional) Allergy (eg: Y/N)
allergy_details	String(255)	(optional) Allergy details (eg: lactose intolerance)
disease_history	String(255)	(optional) Disease history (eg: depression)
cough	Char(1)	(optional) Cough more than 15 days (eg: Y/N)
diabetis	Char(1)	(optional) History of diabetes (eg: Y/N)
smoking	Char(1)	(optional) History of smoking (eg: Y/N)
alcoholism	Char(1)	(optional) History of alcoholism (eg: Y/N)

Get Prescription

Prescription data will be send by POST call to the following url :
pre defined webhook_url


Result example :

{
  "uniqueid": "", //id received from client side
  "medtel_uniqueid": "8b76dac161fcf749a89de428629dad00",
  "patient_name": "Suraj deo",
  "customer_name": "Sunil deo",
  "mobile": "9000000000",
  "address": "Gandhi Chowk ",
  "gender": "Male",
  "age": "11",
  "weight": "38",
  "chief_complain": "Follow up case of itchy red rashes under the armpit.",
  "diagnosis": "Atopic dermatitis ?",
  "medical_tests": "Complete Hemogram,FBS,PPBS Urine routine",
  "prescription": "https://prescription.link",
  "consultant_doctor": "Subhransu Sekhar Jena",
  "consultant_doctor_specialization": "Skin & VD",
  "datetime": "2022-11-21 15:08:03",
  "prescribed_medicines": [
    {
      "medicine_name": "Momate(Lotion)",
      "medicine_strength": "Mometasone furoate 0.1 %W/V",
      "medicine_quantity": "Apply over the affected area night time only.",
      "medicine_days": "20",
      "medicine_time": "Once Daily",
      "medicine_when": ""
    },
    {
      "medicine_name": "Predmet(8 MG)",
      "medicine_strength": "Methylprednisolone 8 MG",
      "medicine_quantity": "1 Tablet ",
      "medicine_days": "17",
      "medicine_time": "Once Daily",
      "medicine_when": "After Breakfast"
    },
    {
      "medicine_name": "Safecet (10 MG) ",
      "medicine_strength": "Levocetirizine 10 MG",
      "medicine_quantity": "1 Tablet",
      "medicine_days": "17",
      "medicine_time": "Once Daily",
      "medicine_when": "Before Dinner"
    },
    {
      "medicine_name": "Cutimax (Lotion)",
      "medicine_strength": "Liquid paraffin 10.2 %W/W+White soft paraffin 13.2 %W/W",
      "medicine_quantity": "Apply over the affected area.",
      "medicine_days": "20",
      "medicine_time": "Twice Daily",
      "medicine_when": ""
    }
  ]
}

Postman Collections

Download Collection

Success


Result example :

{
    "code": 200,
    "status": "OK",
    "msg": "Success"
}

The MedTel API(s) uses the following success codes:

Success Code	Meaning
200	Transaction completed successfully

Errors

The MedTel API(s) uses the following error codes:

Error Code	Meaning
400	Bad Request
401	Parameters are missing
402	Invalid access token
403	Invalid thp id
404	Server error
405	Undefined error

Version CONTROL

API VERSION CONTROL

Version	Date	Log
3.0.2	5 May 2025	Select device preference
3.0.1	26 Dec 2024	Data range, data type validations implemented. session_token limit increased from 30 to 50
3.0.0	15 Jun 2024	WBC implemented.
2.4.20	10 Mar 2024	Implemented renal function test, fundoscope, webhook url.
2.4.19	27 Jan 2024	Implemented rapid test.
2.4.18	21 Apr 2023	Implemented poc screening time.
2.4.17	07 Feb 2023	Implemented FHR.

Test Codes

The MedTel API(s) uses the following test codes:

Test Name	Code
Blood Pressure	BLOOD_PRESSURE
Blood Glucose	BLOOD_GLUCOSE
BMI	BMI
Pulse Oximeter	PULSE_OXIMETER
Temprature	TEMPERATURE
ECG	ECG
Otoscope	OTOSCOPE
Stethoscope	STETHOSCOPE
Hemoglobin	HEMOGLOBIN
FHR	FETAL_DOPPLER
HbA1C	HBA1C
Uric Acid	URIC_ACID
Urine Checkup	URINE_CHECKUP
Spirometer	Spirometer
Blood Grouping	BLOOD_GROUPING
Triglyceride	TG
Total Cholesterol	TC
HDL	HDL
PREGNANCY	PREGNANCY
TYPHOID	TYPHOID
MALARIA	MALARIA
HIV	HIV
HCV	HCV
HEP_B	HEP_B
HEP_C	HEP_C
DENGUE	DENGUE
TROPONIN_1	TROPONIN_1