The Unique careMESH Provider Directory Architecture

Every part of our National Directory is based on the HL7® FHIR® R4 standard. So even though source data is rarely available as a FHIR resource, careMESH converts the data into three types of FHIR resources:

noun_Doctor_1030181.jpg

Practitioner:

Describes an individual person (Physician, Nurse, and support staff) who delivers patient care.

noun_Hospital_2575747.jpg

Organization:

A healthcare organization that is involved with the delivery of patient care.  Examples of organization types are: Hospitals, Skilled Nursing Facilities, Physician Groups, etc.

noun_Globe_1331838.jpg

Location:

A geographic location/facility where patient care is delivered.

Then we use the Practitioner Role, which is a complex object that describes the relationship between the three resource types, to tie it all together.  The below schematic illustrates the complexity of aggregating trusted data sources to deliver careMESH users with the most comprehensive directory available in the market today.

 

The careMESH Directory Schematic

 
 
Screen+Shot+2019-06-04+at+2.26.06+PM.jpg
 
 

Querying the Directory

We publish Hl7® FHIR® standard APIs to allow a user or application to query the directory.  If your organization is using our directory service it is exactly the same API as we use to drive the careMESH Clinical Communications services.  Here are some examples:


1. A simple search for “John Smith” would look like this. At last count there are 207 results in the careMESH directory:

 
GET /v1/listing?_type=Practitioner&_content=john+smith
 

2. The response will look like this, with each John Smith having a unique identifier:

{
 "results": [
   {
     "type": "user",
     "resourceId": "a08a3ece-b886-4513-851d-4e78899f73ac",
     "caremesh": {},
     "practitioner": {
       "id": "a08a3ece-b886-4513-851d-4e78899f73ac",
       ...
     },
     "group": [],
     "hospital": [],
     "locations": []
   },
   ...
 ]
} 
 

3. To retrieve the directory entry for a given practitioner you would include the unique identifier in your next query:

 
GET /v1/listing?_type=Practitioner&_id=a08a3ece-b886-4513-851d-4e78899f73ac&_revinclude=PractitionerRole:practitioner:organization
 

4. The response you will get back looks like this:

{
   "results": [
       {
           "type": "user",
           "resourceId": "a37d6bf9-27b1-4b93-9c31-cbe844d4e356",
           "caremesh": {},
           "practitioner": {
               "id": "a37d6bf9-27b1-4b93-9c31-cbe844d4e356",
               "name": [
                   {
                       "use": "usual",
                       "text": "JOHN M SMITH, MD",
                       "given": [
                           "JOHN",
                           "M"
                       ],
                       "family": "SMITH",
                       "prefix": [],
                       "suffix": [
                           "MD"
                       ]
                   }
               ],
               "active": true,
               "gender": "male",
               "address": [
                   {
                       "use": "work",
                       "city": "LOS ANGELES",
                       "line": [
                           "20199 NATIONAL AVE"
                       ],
                       "text": "20199 NATIONAL AVE\nSUITE 100 \nLOS ANGELES CA 902122632",
                       "state": "CA",
                       "postalCode": "902122632"
                   },
                   {
                       "use": "work",
                       "city": "LOS ANGELES",
                       "line": [
                           "20199 NATIONAL AVE",
                           "#1"
                       ],
                       "text": "20199 NATIONAL AVE\n#1\nLOS ANGELES CA 902122632",
                       "type": "physical",
                       "state": "CA",
                       "country": "US",
                       "postalCode": "902122632"
                   },
                   {
                       "use": "work",
                       "city": "SAN JOSE",
                       "line": [],
                       "type": "physical",
                       "state": "CA",
                       "postalCode": "902122632"
                   }
               ],
               "telecom": [
                   {
                       "use": "work",
                       "rank": 1,
                       "value": "caremesh://urn:healthcelerate:mailbox:1502e9a8-7cf1-4fef-9200-640ffcb1fb3b?type=mail",
                       "system": "url"
                   },
                   {
                       "use": "work",
                       "rank": 2,
                       "value": "directto:smith.john.001.334@direct.athenahealth.com",
                       "system": "url"
                   },
                   {
                       "use": "work",
                       "rank": 3,
                       "value": "caremesh://urn:healthcelerate:mailbox:c51a8760-a812-465d-ae3e-97b823fe21a7?type=text",
                       "system": "url"
                   }
               ],
               "identifier": [
                   {
                       "use": "official",
                       "value": "urn:healthcelerate:user:e84a9d8f-c8be-4c62-8bbe-6280da401345",
                       "system": "http://fhir.caremesh.com/userUrn"
                   },
                   {
                       "use": "official",
                       "value": "1457346843",
                       "system": "http://hl7.org/fhir/sid/us-npi"
                   }
               ],
               "resourceType": "Practitioner",
               "qualification": []
           },
           "group": [],
           "hospital": [],
           "locations": [
               {
                   "id": "609e62f7-6d78-4b3b-98c0-d908eb0874d1",
                   "meta": {
                       "tag": [
                           {
                               "code": "10",
                               "system": "fhir.caremesh.com/internal/source-priority"
                           }
                       ]
                   },
                   "name": "OTHER PRACTICE INFORMATION",
                   "address": {
                       "use": "work",
                       "city": "LOS ANGELES",
                       "line": [],
                       "type": "physical",
                       "state": "CA",
                       "postalCode": "902122632"
                   },
                   "telecom": [
                       {
                           "use": "work",
                           "rank": 1,
                           "value": "caremesh://urn:healthcelerate:mailbox:1502e9a8-7cf1-4fef-9200-640ffcb1fb3b?type=mail",
                           "system": "url"
                       },
                       {
                           "use": "work",
                           "rank": 2,
                           "value": "caremesh://urn:healthcelerate:mailbox:c51a8760-a812-465d-ae3e-97b823fe21a7?type=text",
                           "system": "url"
                       }
                   ],
                   "identifier": [],
                   "resourceType": "Location"
               },
               {
                   "id": "eab2deeb-253e-487c-9c68-27befb82a320",
                   "meta": {
                       "tag": [
                           {
                               "code": "500",
                               "system": "fhir.caremesh.com/internal/source-priority"
                           }
                       ]
                   },
                   "name": "NATIONAL AVE MEDICAL CENTER",
                   "address": {
                       "use": "work",
                       "city": "LOS GATOS",
                       "line": [
                           "20199 NATIONAL AVE"
                       ],
                       "text": "20199 NATIONAL AVE\nSUITE 1 \nLOS GATOS CA 902122632",
                       "state": "CA",
                       "postalCode": "902122632"
                   },
                   "telecom": [
                       {
                           "use": "work",
                           "rank": 1,
                           "value": "4143583448",
                           "system": "phone"
                       }
                   ],
                   "identifier": [],
                   "resourceType": "Location"
               },
               {
                   "id": "92b1072f-0112-402c-997f-13e35d93c48b",
                   "meta": {
                       "tag": [
                           {
                               "code": "1000",
                               "system": "fhir.caremesh.com/internal/source-priority"
                           }
                       ]
                   },
                   "name": "OTHER PRACTICE INFORMATION",
                   "address": {
                       "use": "work",
                       "city": "LOS ANGELES",
                       "line": [
                           "20199 NATIONAL AVE",
                           "#1"
                       ],
                       "text": "20199 NATIONAL AVE\n#1\nLOS ANGELES CA 902122632",
                       "type": "physical",
                       "state": "CA",
                       "country": "US",
                       "postalCode": "902122632"
                   },
                   "telecom": [
                       {
                           "use": "work",
                           "rank": 1,
                           "value": "4193583448",
                           "system": "phone"
                       },
                       {
                           "use": "work",
                           "rank": 2,
                           "value": "4193564628",
                           "system": "fax"
                       }
                   ],
                   "identifier": [],
                   "resourceType": "Location"
               }
           ]
       }
   ]
}
 

5. And here is how we deliver the results within the careMESH U/I:

Screen Shot 2019-05-29 at 6.22.48 PM.png
 

HL7 and FHIR are the registered trademarks of Health Level Seven International.

* Access to DirectTrust protocol secure email addresses is only available to our HISP customers

* DEA and Payer Sources are coming soonstay tuned!