Provider Registry

Context

In "HIE" context, provider registry describes "who provides services" to a patient.

API

The api is loosely based on FHIR practitioner resource.

The broad categories of "providers" are:

* physicians, dentists, pharmacists

* physician assistants, nurses, scribes

* midwives, dietitians, therapists, optometrists, paramedics

* medical technicians, laboratory scientists, prosthetic technicians, radiographers

* community health workers, social workers, professional home carers, official volunteers

* receptionists handling patient registration

* IT personnel in facilities maintaining patient records

* Teachers, Researchers

BHIE

In Bangladesh Context, providers are managed in HRM system. While keeping the API consistent with FHIR practitioners would have been ideal, HRM doesn't necessarily keep the data as par FHIR resource.

For example, Provider name is a simple string, whereas FHIR Practitioner expects as HumanName format.

1. Get Providers

   Request :

   GET {pr_server}/providers/list?limit={limit}&offset={offset}&updatedSince={ISO8601 formatted date}

   Headers :

   X-Auth-Token : {auth token assigned while user registration in HRM}

   client_id : {client id of requester in Identity Service Provider}

   Sample Response :

   [
       {
           "name": "Example Provider",
           "url": "http://{pr_server}/providers/18.json",
           "id": 18,
           "active": 1,
           "createdAt": "2014-11-27 15:23:23",
           "updatedAt": "2014-11-27 15:23:23",
           "birthDate": "1965-10-10",
           "gender": "Male",
           "organization": null,
           "identifiers": [
               {
                   "system": "DGHS",
                   "value": 18
               },
               {
                   "system": "NationalId",
                   "value": null
               },
               {
                   "system": "PDS",
                   "value": "2"
               }
           ],
           "telecom": [
               {
                   "system": "phone",
                   "value": "18912"
               },
               {
                   "system": "email",
                   "value": "drmizanur65@yahoo.com"
               }
           ],
           "address": {
               "text": "UHC, Doctor Quater"
           },
           "properties": {
               "maritalStatus": "Married",
               "freedomFighter": "2",
               "tribial": "Not Tribal",
               "qualification": null,
               "category": "Physican",
               "discipline": "N/A",
               "department": null,
               "attendanceid": null,
               "professionalDiscipline": "N/A",
               "machineid": null
           }
       }
   ]

2. Get Single Provider Information
   

   Request :

   GET {pr_server}/providers/{provider_id}.json

   Headers :

   X-Auth-Token : {auth token assigned while user registration in HRM}

   client_id : {client id of requester in Identity Service Provider}

   Sample Response :

    {
           "name": "Example Provider",
           "url": "http://{pr_server}/providers/18.json",
           "id": 18,
           "active": 1,
           "createdAt": "2014-11-27 15:23:23",
           "updatedAt": "2014-11-27 15:23:23",
           "birthDate": "1965-10-10",
           "gender": "Male",
           "organization": null,
           "identifiers": [
               {
                   "system": "DGHS",
                   "value": 18
               },
               {
                   "system": "NationalId",
                   "value": null
               },
               {
                   "system": "PDS",
                   "value": "2"
               }
           ],
           "telecom": [
               {
                   "system": "phone",
                   "value": "18912"
               },
               {
                   "system": "email",
                   "value": "drmizanur65@yahoo.com"
               }
           ],
           "address": {
               "text": "UHC, Doctor Quater"
           },
           "properties": {
               "maritalStatus": "Married",
               "freedomFighter": "2",
               "tribial": "Not Tribal",
               "qualification": null,
               "category": "Physican",
               "discipline": "N/A",
               "department": null,
               "attendanceid": null,
               "professionalDiscipline": "N/A",
               "machineid": null
           }
       }