Medical Conditions

Search

MD Live offers the ability to search against medical conditions to be used for offering auto-complete suggestions as a patient is creating an appointment or a medical condition. To search, make a request to:

HTTP Request

GET {server_url}/api/v1/clinical_concepts

This request must include a valid User JWT token, please see our documentation

Header Parameter

Parameter	Default
Content-type	application/json
Authorization	Bearer {jwt_token}

The following parameters are accepted when searching medical conditions.

Query String Parameters

Attribute	Required	Description
search	true	Parent attribute for search criteria
↳ term	true	The term to match (string)
↳ limit	false	Limit size of the result set, default size is 10

Example Request

Shell

curl -X GET {server_url}/api/v1/clinical_concepts
-H "Content-type: application/json"
-H "Authorization: Bearer {jwt_token}"
-d '{ "search": {
        "term": "throat",
        "limit": "3"
      }
    }'

Ruby

RestClient::Request.new(
  :method => :get,
  :url => "{server_url}/api/v1/clinical_concepts",
  :headers => {
    "Content-type" => "application/json",
    "Authorization" => "Bearer {jwt_token}"
  },
  :payload => { "search"=> {
                  "term"=> "throat",
                  "limit"=> "3"
                }
              }
).execute

Example Response

{
  "clinical_concepts": [
    {
      "concept_id": 64,
      "concept_type": "Symptom",
      "title": "Throat Pain",
      "icd10": "R07.0",
      "snomed": "267102003"
    },
    {
      "concept_id": 3539,
      "concept_type": "Symptom",
      "title": "Throat Redness (or Red Spots)",
      "icd10": "J02.9",
      "snomed": "126662008"
    },
    {
      "concept_id": 3544,
      "concept_type": "Symptom",
      "title": "Throat Swelling (Swollen Tonsils)",
      "icd10": "R22.1",
      "snomed": "421581006"
    }
  ]
}

Create

To create a medical condition for a patient, make a request to:

HTTP Request

POST {server_url}/api/v1/patients/{patient_id}/medical_conditions

This request must include a valid User JWT token, please see our documentation

Header Parameter

Parameter	Default
Content-type	application/json
Authorization	Bearer {jwt_token}

The following parameters are required when creating a medical condition. To search for the condition and retrieve needed parameter values, reference clinical concepts - search.

URL Parameter

Attribute	Required	Description
patient_id	true	MD Live ID for patient

Request Body Parameters

Attribute	Required	Description
medical_condition	true	Parent attribute for condition
↳ condition	true	Description of condition
↳ source	false	‘Self Reported’
↳ concept_id	false	Concept ID returned in Clinical Concepts search
↳ snomed	false	SNOMED returned in Clinical Concepts search
↳ icd10	false	ICD-10 code returned in Clinical Concepts search

Example Request

Shell

curl -X POST {server_url}/api/v1/patients/{patient_id}/medical_conditions
-H "Content-type: application/json"
-H "Authorization: Bearer {jwt_token}"
-d '{
      "medical_condition": {
        "condition": "Throat Pain",
        "source": "Self Reported",
        "concept_id": "64",
        "snomed": "267102003",
        "icd10": "R07.0"
      }
    }'

Ruby

RestClient::Request.new(
  :method => :post,
  :url => "{server_url}/api/v1/patients/{patient_id}/medical_conditions",
  :headers => {
    "Content-type" => "application/json",
    "Authorization" => "Bearer {jwt_token}"
  },
  :payload => {
                 "medical_condition"=> {
                   "condition"=> "Throat Pain",
                   "source"=> "Self Reported",
                   "concept_id"=> "64",
                   "snomed"=> "267102003",
                   "icd10"=> "R07.0"
                 }
               }
).execute

Example Response

{
  "patient_id": 111,
  "medical_condition": {
    "id": 123,
    "condition": "Throat Pain",
    "source": "Self Reported",
    "concept_id": "64",
    "snomed": "267102003",
    "icd10": "R07.0",
    "date_reported": "2017-11-13T15:47:40.000-05:00",
    "last_updated_date": "2017-11-13T15:47:40.000-05:00",
    "active": true
  }
}

Delete

To remove a medical condition from a patient’s list of conditions, make a request to:

HTTP Request

DELETE {server_url}/api/v1/patients/{patient_id}/medical_conditions/{medical_condition_id}

This request must include a valid User JWT token, please see our documentation

Header Parameter

Parameter	Default
Content-type	application/json
Authorization	Bearer {jwt_token}

The following parameters are required when removing a medical condition.

URL Parameter

Attribute	Required	Description
patient_id	true	MD Live ID for patient
id	true	ID of patient’s medical condition

Example Request

Shell

curl -X DELETE {server_url}/api/v1/patients/{patient_id}/medical_conditions/{medical_condition_id}
-H "Content-type: application/json"
-H "Authorization: Bearer {jwt_token}"

Ruby

RestClient::Request.new(
  :method => :delete,
  :url => "{server_url}/api/v1/patients/{patient_id}/medical_conditions/{medical_condition_id}",
  :headers => {
    "Content-type" => "application/json",
    "Authorization" => "Bearer {jwt_token}"
  }
).execute

List

To retrieve the list of a patient’s current list of medical conditions, make a request to:

HTTP Request

GET {server_url}/api/v1/patients/{patient_id}/medical_conditions

This request must include a valid User JWT token, please see our documentation

Header Parameter

Parameter	Default
Content-type	application/json
Authorization	Bearer {jwt_token}

The following parameters are required to retrieve the list of patient’s medical conditions.

URL Parameter

Parameter	Required	Description
patient_id	true	MD Live ID for patient

Example Request

Shell

curl -X GET {server_url}/api/v1/patients/{patient_id}/medical_conditions
-H "Content-type: application/json"
-H "Authorization: Bearer {jwt_token}"

Ruby

RestClient::Request.new(
  :method => :get,
  :url => "{server_url}/api/v1/patients/{patient_id}/medical_conditions",
  :headers => {
    "Content-type" => "application/json",
    "Authorization" => "Bearer {jwt_token}"
  }
).execute

Example Response

{
  "medical_conditions": [
    {
      "patient_id": 111,
      "medical_condition": {
        "id": 123,
        "condition":"Anemia - Aplastic",
        "source":"Self Reported",
        "concept_id": "526",
        "snomed": "306058006",
        "icd10": "D61.9",
        "date_reported": "2017-11-18T12:45:28.000-05:00",
        "last_updated_date": "2017-11-18T12:45:28.000-05:00",
        "active": true
      }
    },
    {
      "patient_id": 111,
      "medical_condition":{
        "id":12345,
        "condition":"Asthma",
        "source":"Dr Jane Doe",
        "concept_id": "3488",
        "snomed": "195967001",
        "icd10": "J45.909",
        "date_reported": "2017-11-13T15:47:40.000-05:00",
        "last_updated_date": "2017-11-13T15:47:40.000-05:00",
        "active": true
      }
    }
  ]
}