1.

Authentication
 Token provided by auth nhif servers

2. Share Patient Data

 Visit Information
- request_type : string
- full_name : string
- phone_number : string
- nida_number : string
- date_of_birth : string
- gender : string
- picture : string
- deceased : string
- visit_id : number | integer
- patient_id : number | integer
- authorization_no : string
- visit_date : string

- /v1/share/ : post request

Payload Sample Success Response Error Response

{ status code : 201
"request_type": "visit", { msg: “visit saved” }
"patient_demographics": {
"full_name": "Martha E Kiwia",
"phone_number": "255756787669",
"member_number": "406500706730",
"nida_number": "",
"date_of_birth": "1943-12-01",
"gender": "female",
"picture": "null",
"deceased": "no"
},
"visits": {
"visit_id": 1159676,
"patient_id": 46586,
"authorization_no": "111328362785",
"visit_date": "2023-11-03 12:21:12"
}
}

 Clinical Note
- request_type : string
- authorization_no : string
- diagnosis : array
- diagnosis_code : string
- diagnosis_name : string
- icd_code : string
- type : string
- date : string
- medical_history : object
- main_complain : string
- history_past_illness : string
- social_history : string
- general_observation : string

Plot 436 Avocado Street, Kawe – Dar es Salaam, Tanzania. P.O. Box 78118 Dar es Salaam, Tanzania.
info@GPITG.co.tz www.GPITG.co.tz +255 717 531 539 +255753290357
 - systemic_observation : string
- doctor_plan_suggestion : string
- mct : string

- /v1/share/ : post request

Payload Sample Success Response Error Response

{ status code : 201
"request_type": "clinical_notes", { msg: “notes saved” }
"authorization_no": "111328362785",
"diagnosis": [
{
"diagnosis_code": "L30",
"diagnosis_name": "Other dermatitis",
"icd_code": "icd_10",
"type": "provisional_diagnosis",
"date": "2023-11-03 13:01:16"
},
{
"diagnosis_code": "L30",
"diagnosis_name": "Other dermatitis",
"icd_code": "icd_10",
"type": "final_diagnosis",
"date": "2023-11-03 13:01:27"
}
],
"medical_history": {
"main_complain": "Seen pt with itch.",
"history_of_Illness": "",
"social_history": "nad",
"general_observation": "Stable",
"systemic_observation": "Clinically",
"doctor_plan_suggestion": "",
"mct": "MCTOL285"
}
}

 Treatment ‘Pharmacy’
- request_type : string
- authorization_no : string
- medication : array
- item_code : string
- item_name : string
- attachment : string
- service_date : string
- quantity : number
- dosage : string
- service_type : string

- /v1/share/ : post request

Payload Sample Success Response Error Response

{ status code : 201
"request_type": "treatment", { msg: “medication saved” }
"authorization_no": "111328362785",
"medication": [
{
"item_code": "Pharmacy",
"item_name": "Aceclofenac 0.01% 100g",
"attachment": null,

Plot 436 Avocado Street, Kawe – Dar es Salaam, Tanzania. P.O. Box 78118 Dar es Salaam, Tanzania.
info@GPITG.co.tz www.GPITG.co.tz +255 717 531 539 +255753290357
 "service_date": "2023-11-03 13:23:57",
"quantity": 1,
"dosage": "
Dosage: 100g; Route: TOPICAL; Frequency: BD;
Duration: 1 /12; Comments: apply on the face",
"service_type": "pharmacy"
},
{
"item_code": "Pharmacy",
"item_name": "
Methamphetamine 0.025% Valerate 50g",
"attachment": null,
"service_date": "2023-11-03 13:23:55",
"quantity": 2,
"dosage": "
Dosage: 50g; Route: TOPICAL; Frequency: OD;
Duration: 1 /12; Comments: apply on the body",
"service_type": "pharmacy"
},
]
}

 Investigation ‘Procedure, Laboratory & Radiology’

- request_type : string
- authorization_no : string
- investigation : object
- item_code : string
- item_name : string
- attachment : string
- service_date : string
- quantity : number
- service_type : string
- result : string

- /v1/share/ : post request

Payload Sample Success Response Error Response

{ status code : 201
"authorization_no": "111327856927", { msg: “investigation
"request_type": "investigation", saved” }
"investigation": {
"item_code": "5208",
"item_name": "Serum/Blood Creatinine",
"attachment": "null",
"quantity": 1,
"service_date": "
2023-11-27T12:35:54.868407Z",
"remark": "Coughing",
"service_type": "laboratory",
"result": []
},
"result": null
}

3. Get Patient Data

 Get patient visits
- member_number : string

- /v1/share/ : post request

Plot 436 Avocado Street, Kawe – Dar es Salaam, Tanzania. P.O. Box 78118 Dar es Salaam, Tanzania.
info@GPITG.co.tz www.GPITG.co.tz +255 717 531 539 +255753290357
 Param Success Response
member_number [
{
"authorization_no": "00000000000",
"facility_code": "0000",
"facility_name": "test",
"visit_date": "2023-11-22T12:49:03.000Z"
}
]

 Get single patient file

- authorization_no : string
- /v1/share/000000000000

Param Success Response

authorization_no {
"patient_uid": 7,
"facility_code": "03342",
"authorization_no": "101132785695",
"visit_date": "2023-11-22T12:49:03.000Z",
"visit_json": null,
"created_at": "2023-11-22T21:23:58.104Z",
"updated_at": "2023-11-22T21:23:58.104Z",
"ClinicalNote": [
{
"mct": "00000",
"main_complain": null,
"history_of_illness": "
Acute lymphoblastic leukemia",
"social_history": "
presumed nephroblastoma",
"general_observation": "
general nursing care",
"systemic_observation": "
difficulty in breathing poor urine
output risk of tumor lysis syndrome",
"doctor_plan_suggestion": "
presumed nephroblastoma",
"created_at": "
2023-11-22T21:25:11.364Z",
"updated_at": "
2023-11-22T21:25:11.364Z"
}
],
"services": [
{
"item_code": "11227",
"item_name": "
Bicalutamide/Casodex 50mg",
"attachment": null,
"service_date": "
2023-11-21T13:07:29.000Z",
"quantity": 600,
"dosage": "
Dosage: 50mg; Route: PO;
Frequency: BD; Duration: 10 /12; ",

Plot 436 Avocado Street, Kawe – Dar es Salaam, Tanzania. P.O. Box 78118 Dar es Salaam, Tanzania.
info@GPITG.co.tz www.GPITG.co.tz +255 717 531 539 +255753290357
 "service_type": "pharmacy",
"image_path": null,
"result": null,
"remark": null,
"created_at": "
2023-11-22T21:25:50.897Z",
"updated_at": "
2023-11-22T21:25:50.897Z"
},
{
"item_code": "5140",
"item_name": "MRI Abdomen",
"attachment": null,
"service_date": "
2023-11-21T16:56:18.000Z",
"quantity": 1,
"dosage": null,
"service_type": "radiology",
"image_path": null,
"result": [
{
"remark": null,
"status": null,
"ref_range": null,
"parameter_name": "REPORT",
"parameter_result": ""
}
],
"remark": null,
"created_at": "
2023-11-22T21:26:22.917Z",
"updated_at": "
2023-11-22T21:26:22.917Z"
}
}

 Get items result

- authorization_no : string
- item_code : string
- /v1/share/result?authorization_no=101132785695&item_code=5140

Param Success Response

authorization_no {
item_code "item_code": "5140",
"item_name": "MRI Abdomen",
"attachment": null,
"service_date": "
2023-11-21T16:56:18.000Z",
"quantity": 1,
"dosage": null,
"service_type": "radiology",
"image_path": null,
"result": [
{
"remark": null,

Plot 436 Avocado Street, Kawe – Dar es Salaam, Tanzania. P.O. Box 78118 Dar es Salaam, Tanzania.
info@GPITG.co.tz www.GPITG.co.tz +255 717 531 539 +255753290357
 "status": null,
"ref_range": null,
"parameter_name": "REPORT",
"parameter_result": ""
}
],
"remark": null,
"created_at": "
2023-11-22T21:26:22.917Z",
"updated_at": "
2023-11-22T21:26:22.917Z"
}
}

 Get images
- authorization_no : string
- /v1/share/images?authorization_no=101132785695

Param Success Response

authorization_no [
"url/v1/share/file?uuid=c3300186-d122-
4c7b-9935-88e189f3b468"
]

Plot 436 Avocado Street, Kawe – Dar es Salaam, Tanzania. P.O. Box 78118 Dar es Salaam, Tanzania.
info@GPITG.co.tz www.GPITG.co.tz +255 717 531 539 +255753290357