If your facility has a hospital management system or EMR, you can connect with us
to get Health ID for your Clients. Please follow the following Instruction and API’s.
feel free to contact us for any issues.
Base API:
Dev server:
SSO: https://dev.hris.survport.com/api/1.0/sso/signin
MCI : http://mci.mcishr.dghs.gov.bd
Encounter : https://shr.mcishr.dghs.gov.bd
TR : https://tr.mcishr.dghs.gov.bd
Facility : https://dev.hris.survport.com/api/1.0/facilities/{{facility-id}}.json
Provider : https://dev.hris.survport.com/api/1.0/providers/{{provider-id}}.json
Live server:
SSO: https://hrm.dghs.gov.bd/api/1.0/sso/signin
MCI : https://mci.shrlive.dghs.gov.bd/api/v1/patients
Encounter : https://shr.shrlive.dghs.gov.bd/patients
TR : https://tr.shrlive.dghs.gov.bd
Facility : https://hrm.dghs.gov.bd/api/1.0/facilities/{{facility-id}}.json
Provider : https://hrm.dghs.gov.bd/api/1.0/providers/{{provider-id}}.json
SSO API:
api_endpoints : method→ post : https://dev.hris.survport.com/api/1.0/sso/signin
Headers:
X-Auth-Token:16Vi1a4CNBDi……………….5ozNz5E6wmY49Po0ZOanjolsLoL5O
client-id: 191369
Body:
email: apishr@gmail.com
password: …….
Response:
{
“access_token”: “338719dd-fc44-463f-b31d-4442ee15d752”
}
Verify SSO token:
api_endpoints : method→ post : https://dev.hris.survport.com/api/1.0/sso/token/{sso_token}
Headers:
X-Auth-Token: 9056dc8a73d…………………..995bf5785fa30febd06bf7eb3f3e
client-id: 187075
NID API:
api_endpoints : method→ post : https://nidproxy.mcishr.dghs.gov.bd/verify-and-get-data
Headers:
email:alo.karail@gmail.com
X-Auth-Token: 838772d6-………8-81663632a15a
client-id: 187058
Content-Type:application/json
Body:
{
“performer”:“0f3ea8ea-a38a-433f-8cdc-c4d77efa04a8”,
“nidOrBrn”:“1234567890”,
“Type”:“nid”, or “brn”
“name”:“Md Karim Mia”,
“dob”:“1986-05-10”,
“mobile”:“01766940071”
}
Response:
{
“verifyToken”: “a9a98eac-68c4-4dd1-9cb9-8127a5b44833”,
“citizenData”: {
“mobile”: null,
“fullName_English”: “Md KarimI Mia”,
“motherName_English”: “”,
“motherName_Bangla”: “মোসাঃ ….. বেগম”,
“fatherName_English”: “”,
“fatherName_Bangla”: “মোঃ আঃ ……….”,
“permanentHouseholdNoText”: null,
“dob”: “1986-05-10”,
“bin_BRN”: null,
“gender”: 1,
“fullName_Bangla”: “মোঃ ….. ইসলাম”,
“presentHouseholdNoText”: null,
“citizen_nid”: “1234567890”,
“permanentHouseholdNo”: {
“division”: “ঢাকা”,
“district”: “নারায়ণগঞ্জ”,
“upazilla”: “সোনারগাঁও”,
“unionOrWard”: null,
“mouzaOrMoholla”: “পাইকপাড়া”,
“villageOrRoad”: “চেঙ্গাকান্দি”,
“houseOrHoldingNo”: “”,
“address_line”: null
},
“presentHouseholdNo”: {
“division”: “ঢাকা”,
“district”: “নারায়ণগঞ্জ”,
“upazilla”: “সোনারগাঁও”,
“unionOrWard”: “বারদী”,
“mouzaOrMoholla”: “পাইকপাড়া”,
“villageOrRoad”: “চেঙ্গাকান্দি”,
“houseOrHoldingNo”: “”,
“address_line”: null
}
}
}
MCI API:
Patient Search:
GET :
By Health ID: api_endpoints : method→ get: http://mci.mcishr.dghs.gov.bd/api/v1/patients/{hid}
BY NID: api_endpoints: method→ get: http://mci.mcishr.dghs.gov.bd/api/v1/patients?nid=1234567890
BY BRN: api_endpoints: method→get: http://mci.mcishr.dghs.gov.bd/api/v1/patients?bin_brn=1234567890
BY Phone No: api_endpoints: method→get: http://mci.mcishr.dghs.gov.bd/api/v1/patients?phone_no=01766254432
Patient Create/ HID generate:
api_endpoints : method→ post : http://mci.mcishr.dghs.gov.bd/api/v1/patients
Headers:
Content-Type:application/json
From:alo.karail@gmail.com
X-Auth-Token:c49019f2-7656-40cb-8e6f-f5deee494236
client-id:187058
Body :
{
“nid”: “1234567890”,
“given_name”: “Arian Islam”,
“sur_name”: “Islam”,
“gender”: “M”,
“date_of_birth”: “2018-02-24T18:00:00.000Z”,
“present_address”: {
“address_line”: “xyz”,
“division_id”: “30”,
“district_id”: “26”,
“upazila_id”: “02”,
“holding_number”: “Level 2,Taj Garden,House no.4/k”,
“street”: “Plot 51,Satmasjid Road”,
“area_mouja”: “Dhanmondi”,
“village”: “Lalmatia”,
“post_office”: “Mohammadpur”,
“post_code”: “1207”,
“country_code”: “050”
},
“phone_number”: {
“number”: “01566940080”
},
“active”: true
}
Response:
{
“http_status”: 201,
“id”: “98000823925”
}
Accepted Search Parameter –
| Search Parameter | URL | Description |
| HID | /api/v1/patients/5927191746319482881 | Search can be done with the help of HID. |
| NID,BRN & UID | /api/v1/patients?nid=19905678901234567 | Search can be done using both single and multiple IDs.
NID must be 13/17 characters; BRN must be 17 characters; UID must be 11 characters. |
| /api/v1/patients?nid=19905678901234567&present_address=100409 | ID can be individually used for searching a patient. In addition, ID can be combined with Present Address to search a patient. | |
| Present Address | /api/v1/patients?present_address=100409 | Address must be minimum 6 geocode which indicates address from Division to Upazilla level. |
| /api/v1/patients?present_address=10040920 | Address can be 8 geocode which indicates address up to city corporation level. | |
| /api/v1/patients?present_address=1004092006 | Address can be maximum 10 geocode which is up to ward/union level. | |
| Name & Address | /api/v1/patients?given_name=Alif khan&present_address=557364 | Both Given name and Surname must be combined with Present Address.
Both Given Name and Surname must be the exact word (case insensitive) to search a patient. |
| /api/v1/patients?sur_name=Ali&present_address=55736450 | ||
| Phone number & Address | /api/v1/patients?phone_no=9678909&country_code=008&area_code=02&extension= 0984&present_address=100409 | Phone number must be combined with Present Address.
Phone no. must be the minimum requirement to search a patient by Phone Number. In addition, search can be done using Country Code, Area Code and Extension with Phone No. |
| /api/v1/patients?phone_no=9678909&present_address=100419 | ||
| Household code | /api/v1/patients?household_code=132452213123 | Household code must be only number and there is no length restriction as of now |
For Further information please contact us.