POST api/DrugToLifestyle

Returns all documented drug-lifestyle interactions for each drug passed into the request. Requires no input of lifestyle factors to check for lifestyle interactions. Returns the Lifestyle concept involved in the interaction, as opposed to an interacting drug class. Also provides ‘Alert Optimizer’ filtering options to reduce alert fatigue by suppressing alerts and/or excluding drug results based on individual clinician's preferences or by customizing results specific to a patient.


Request Information

URI Parameters

None.

Body Parameters

DrugToLifestyleRequest
NameDescriptionTypeAdditional information
IncludeProfessionalNotes If this is set to 'true' the Professional notes for each possible interaction will be returned in the response. This is 'false' by default. boolean

None.

IncludeConsumerNotes If this is set to 'true' the Consumer notes for each possible interaction will be returned in the response. This is 'false' by default. boolean

None.

CheckUnderDevelopment The CheckUnderDevelopment parameter is used to check the input drug identifiers for monographs with interaction content still under development. This parameter is optional. It accepts a Boolean value (true/false) to turn on or off (default value is “false”). boolean

None.

PrescribingDrugs Use the PrescribingDrugs collection to pass in the identifiers of drugs currently being dispensed. (i.e. Products being assigned to this patient during this dispensing/checking event.) Collection of ClinicalDrugIdentifier

Required

PrescribedDrugs Use the PrescribedDrugs collection to pass in the identifiers of drugs that are considered active on the patient's medical history. If the IgnorePrescribed flag is false, then the PrescribedDrugs collection is required. Collection of ClinicalDrugIdentifier

None.

IgnorePrescribed The IgnorePrescribed flag is used to disregard (or not to disregard) the PrescribedDrugs collection. If the Boolean value is set to ‘true’ the Clinical method only checks the PrescribingDrugs collection against the PrescribedDrugs collection, but does not check within the PrescribedDrugs collection itself. The IgnorePrescribed flag is optional. It accepts a Boolean value (true/false) to turn on or off (default is set to “false”). boolean

None.

FilterPreferences All warnings, drugs, etc., for each supplied identifier are filtered out of the response. FilterPreferences

None.

AccessToken Temporary access token from the GSDD Auth API. Used to validate your license.

Note: Access tokens are temporary and may be invalidated early for various reasons, including—but not limited to—site maintenance and security updates. If a token is invalidated prematurely, simply request new tokens via the AccessToken method in the GSDD Auth API. This is a rather rare occurrence, but should be planned for and handled by the consuming application.
string

Required

Request Formats

application/json, text/json

Sample:
{
  "IncludeProfessionalNotes": true,
  "IncludeConsumerNotes": true,
  "CheckUnderDevelopment": true,
  "PrescribingDrugs": [
    {
      "IdType": "NDC11",
      "Id": "12345-6789-01"
    },
    {
      "IdType": "NDC11",
      "Id": "12345-6789-02"
    }
  ],
  "PrescribedDrugs": [
    {
      "IdType": "NDC11",
      "Id": "12345-6789-03"
    },
    {
      "IdType": "NDC11",
      "Id": "12345-6789-04"
    }
  ],
  "IgnorePrescribed": false,
  "FilterPreferences": {
    "Patient": [
      {
        "IdType": "IngredientId",
        "Id": "5"
      },
      {
        "IdType": "IngredientId",
        "Id": "6"
      }
    ],
    "Physician": [
      {
        "IdType": "IngredientId",
        "Id": "7"
      },
      {
        "IdType": "IngredientId",
        "Id": "8"
      }
    ]
  },
  "AccessToken": "T25lX0hhcHB5X0FuZF9TYXRpc2ZpZWRfR1NERF9DdXN0b21lcl9TYW1wbGVfQWNjZXNzVG9rZW4="
}

Response Information

Resource Description

DrugToLifestyleResponse
NameDescriptionTypeAdditional information
LifestyleInteractions A collection of drug identifiers that where screened for possible Drug to Lifestyle interactions. Collection of LifestyleInteractions

None.

UnderDevelopment When the CheckUnderDevelopment input parameter is set to 'true' in the request, this element returns collection of drug identifiers passed into the request with monograph interaction content still under development. Collection of InteractionsUnderDevelopment

None.

DrugsNotChecked Any drug identifier passed into the request that is not found in the Gold Standard Drug Database is shown in the DrugsNotChecked collection. This allows all other drugs to be checked normally, while still alerting the user that an identifier passed into the request was not found. Collection of ClinicalDrugIdentifier

None.

Response Formats

application/json, text/json

Sample:
{
  "LifestyleInteractions": [
    {
      "Interactions": [
        {
          "LifestyleId": 1,
          "ConceptId": 2,
          "ConceptName": "Sample ConceptName text.",
          "InteractionClass": {
            "Id": 3,
            "Name": "Sample Name text.",
            "Ingredients": [
              {
                "Id": 4,
                "Name": "Sample Name text."
              },
              {
                "Id": 5,
                "Name": "Sample Name text."
              }
            ],
            "DSMRoute": {
              "Id": 6,
              "Name": "Sample Name text."
            }
          },
          "ClinicalManagementStatement": [
            "Sample ClinicalManagementStatement text.",
            "Sample ClinicalManagementStatement text."
          ],
          "ConsumerNotes": "Sample ConsumerNotes text.",
          "Documentation": {
            "Ranking": 1,
            "Text": "Sample Text text."
          },
          "ProfessionalNotes": "Sample ProfessionalNotes text.",
          "ProfessionalNotesAbbr": "Sample ProfessionalNotesAbbr text.",
          "Severity": {
            "Ranking": 1,
            "Text": "Sample Text text."
          }
        },
        {
          "LifestyleId": 7,
          "ConceptId": 8,
          "ConceptName": "Sample ConceptName text.",
          "InteractionClass": {
            "Id": 9,
            "Name": "Sample Name text.",
            "Ingredients": [
              {
                "Id": 10,
                "Name": "Sample Name text."
              },
              {
                "Id": 11,
                "Name": "Sample Name text."
              }
            ],
            "DSMRoute": {
              "Id": 12,
              "Name": "Sample Name text."
            }
          },
          "ClinicalManagementStatement": [
            "Sample ClinicalManagementStatement text.",
            "Sample ClinicalManagementStatement text."
          ],
          "ConsumerNotes": "Sample ConsumerNotes text.",
          "Documentation": {
            "Ranking": 1,
            "Text": "Sample Text text."
          },
          "ProfessionalNotes": "Sample ProfessionalNotes text.",
          "ProfessionalNotesAbbr": "Sample ProfessionalNotesAbbr text.",
          "Severity": {
            "Ranking": 1,
            "Text": "Sample Text text."
          }
        }
      ],
      "DrugId": {
        "IdType": "NDC11",
        "Id": "12345-6789-04"
      },
      "DrugName": "Sample DrugName text.",
      "RequestSource": "Prescribing"
    },
    {
      "Interactions": [
        {
          "LifestyleId": 14,
          "ConceptId": 15,
          "ConceptName": "Sample ConceptName text.",
          "InteractionClass": {
            "Id": 16,
            "Name": "Sample Name text.",
            "Ingredients": [
              {
                "Id": 17,
                "Name": "Sample Name text."
              },
              {
                "Id": 18,
                "Name": "Sample Name text."
              }
            ],
            "DSMRoute": {
              "Id": 19,
              "Name": "Sample Name text."
            }
          },
          "ClinicalManagementStatement": [
            "Sample ClinicalManagementStatement text.",
            "Sample ClinicalManagementStatement text."
          ],
          "ConsumerNotes": "Sample ConsumerNotes text.",
          "Documentation": {
            "Ranking": 2,
            "Text": "Sample Text text."
          },
          "ProfessionalNotes": "Sample ProfessionalNotes text.",
          "ProfessionalNotesAbbr": "Sample ProfessionalNotesAbbr text.",
          "Severity": {
            "Ranking": 2,
            "Text": "Sample Text text."
          }
        },
        {
          "LifestyleId": 20,
          "ConceptId": 21,
          "ConceptName": "Sample ConceptName text.",
          "InteractionClass": {
            "Id": 22,
            "Name": "Sample Name text.",
            "Ingredients": [
              {
                "Id": 23,
                "Name": "Sample Name text."
              },
              {
                "Id": 24,
                "Name": "Sample Name text."
              }
            ],
            "DSMRoute": {
              "Id": 25,
              "Name": "Sample Name text."
            }
          },
          "ClinicalManagementStatement": [
            "Sample ClinicalManagementStatement text.",
            "Sample ClinicalManagementStatement text."
          ],
          "ConsumerNotes": "Sample ConsumerNotes text.",
          "Documentation": {
            "Ranking": 2,
            "Text": "Sample Text text."
          },
          "ProfessionalNotes": "Sample ProfessionalNotes text.",
          "ProfessionalNotesAbbr": "Sample ProfessionalNotesAbbr text.",
          "Severity": {
            "Ranking": 2,
            "Text": "Sample Text text."
          }
        }
      ],
      "DrugId": {
        "IdType": "NDC11",
        "Id": "12345-6789-08"
      },
      "DrugName": "Sample DrugName text.",
      "RequestSource": "Prescribing"
    }
  ],
  "UnderDevelopment": [
    {
      "DrugId": {
        "IdType": "NDC11",
        "Id": "12345-6789-00"
      },
      "RequestSource": "Prescribing",
      "MonographId": 28,
      "Message": "Sample Message text."
    },
    {
      "DrugId": {
        "IdType": "NDC11",
        "Id": "12345-6789-02"
      },
      "RequestSource": "Prescribing",
      "MonographId": 30,
      "Message": "Sample Message text."
    }
  ],
  "DrugsNotChecked": [
    {
      "IdType": "NDC11",
      "Id": "12345-6789-04"
    },
    {
      "IdType": "NDC11",
      "Id": "12345-6789-05"
    }
  ]
}