POST api/DrugDiseaseMatchDrugToDiagnosis

Identifies drug therapy and the associated diagnosis. Additionally identifies drug therapy with no associated diagnoses and diagnoses with no associated drug therapy. Identifies all specific products that match or are related to the drug identifiers entered in the request. Identifies one or more items from both the list of drug identifiers and the list of indications, then compares each drug to each diagnosis, and each diagnosis to each drug through Gold Standard (GS) indication to find matches. Checks for editorial exclusion using the associated Generic Product Clinical concept, and then looks up all GS indications found for the drug (either by Specific Product Id or Generic Product Climical Id). Categorizes results by drug identifier and name, and clearly identifies which drugs are associated to which indications.


Request Information

URI Parameters

None.

Body Parameters

DrugDiseaseMatchDrugToDiagnosisRequest
NameDescriptionTypeAdditional information
LabelStatus Indicates whether to include on-label or off-label indications for the drug in the response. Default is both. LabelStatusEnum

None.

DiagnosingCodes Collection of codes for diseases being diagnosed. Collection of ConditionIdentifier

Required

DiagnosedCodes Collection of diagnosis codes for diagnosed diseases. Collection of ConditionIdentifier

None.

PrescribingDrugs Collection of identifers for drugs being prescribed. Collection of ADRDrugIdentifier

Required

PrescribedDrugs Collection of identfiers for drugs currently prescribed. Collection of ADRDrugIdentifier

None.

IgnoreDiagnosed Set this to true to ignore the diagnosed collection of codes when matching drugs. Default is false. boolean

None.

IgnorePrescribed Set this to true to ignore the prescribed collection of drugs when matching diagnosis. Default is false. boolean

None.

DateOfBirth Used to filter the response based on a calculated age. API converts Date of Birth (DOB) into age and then matches to an age group. date

Required

Gender Used to filter based on gender. Default is both. GenderEnum

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:
{
  "LabelStatus": "OnLabel",
  "DiagnosingCodes": [
    {
      "IdType": "ICD10",
      "Id": "123ABC1"
    },
    {
      "IdType": "ICD10",
      "Id": "123ABC2"
    }
  ],
  "DiagnosedCodes": [
    {
      "IdType": "ICD10",
      "Id": "123ABC3"
    },
    {
      "IdType": "ICD10",
      "Id": "123ABC4"
    }
  ],
  "PrescribingDrugs": [
    {
      "IdType": "NDC11",
      "Id": "12345-6789-05"
    },
    {
      "IdType": "NDC11",
      "Id": "12345-6789-06"
    }
  ],
  "PrescribedDrugs": [
    {
      "IdType": "NDC11",
      "Id": "12345-6789-07"
    },
    {
      "IdType": "NDC11",
      "Id": "12345-6789-08"
    }
  ],
  "IgnoreDiagnosed": false,
  "IgnorePrescribed": false,
  "DateOfBirth": "2024-05-18",
  "Gender": "Female",
  "AccessToken": "T25lX0hhcHB5X0FuZF9TYXRpc2ZpZWRfR1NERF9DdXN0b21lcl9TYW1wbGVfQWNjZXNzVG9rZW4="
}

Response Information

Resource Description

DrugDiseaseMatchDrugToDiagnosisResponse
NameDescriptionTypeAdditional information
Matches A collection of drug identifiers matched to conditions or disease identifiers in the request. Collection of DrugDiseaseMatchInfo

None.

DrugsNotMatched A collection of drug identifiers that do not match any supplied conditions or diseases identifiers. Collection of ADRDrugInfo

None.

DrugsNotFound A collection of drug identifiers not found in the Gold Standard Drug Database. Collection of ADRDrugInfo

None.

DiagnosesNotMatched A collection of conditions or diagnosis identifiers that have no therapy details for the supplied drug identifiers. Collection of ConditionIdentifierInfo

None.

DiagnosesWithNoDrugThearapy A collection of conditions or diagnosis identifiers with no associated drug therapy. Collection of ConditionIdentifierInfo

None.

Response Formats

application/json, text/json

Sample:
{
  "Matches": [
    {
      "Drug": {
        "RequestSource": "Prescribing",
        "LabelStatus": "OnLabel",
        "DrugId": {
          "IdType": "NDC11",
          "Id": "12345-6789-01"
        },
        "Name": "Sample Name text.",
        "LevelsOfEvidence": [
          {
            "Recommended": true,
            "StrengthOfRecommendation": "EquivocalWeakAgainst",
            "Rating": "VeryLow",
            "ErrorMessage": "Sample ErrorMessage text."
          },
          {
            "Recommended": true,
            "StrengthOfRecommendation": "EquivocalWeakAgainst",
            "Rating": "VeryLow",
            "ErrorMessage": "Sample ErrorMessage text."
          }
        ],
        "Message": "Sample Message text."
      },
      "Condition": {
        "LevelsOfEvidence": [
          {
            "Recommended": true,
            "StrengthOfRecommendation": "EquivocalWeakAgainst",
            "Rating": "VeryLow",
            "ErrorMessage": "Sample ErrorMessage text."
          },
          {
            "Recommended": true,
            "StrengthOfRecommendation": "EquivocalWeakAgainst",
            "Rating": "VeryLow",
            "ErrorMessage": "Sample ErrorMessage text."
          }
        ],
        "RequestSource": "Diganosed",
        "ConditionId": {
          "IdType": "ICD10",
          "Id": "123ABC2"
        },
        "Description": "Sample Description text.",
        "InfoMessage": "Sample InfoMessage text."
      },
      "MonographSectionId": 3,
      "AgeBands": [
        {
          "Name": "Sample Name text.",
          "Gender": "Female"
        },
        {
          "Name": "Sample Name text.",
          "Gender": "Female"
        }
      ],
      "Message": "Sample Message text."
    },
    {
      "Drug": {
        "RequestSource": "Prescribing",
        "LabelStatus": "OnLabel",
        "DrugId": {
          "IdType": "NDC11",
          "Id": "12345-6789-04"
        },
        "Name": "Sample Name text.",
        "LevelsOfEvidence": [
          {
            "Recommended": true,
            "StrengthOfRecommendation": "EquivocalWeakAgainst",
            "Rating": "VeryLow",
            "ErrorMessage": "Sample ErrorMessage text."
          },
          {
            "Recommended": true,
            "StrengthOfRecommendation": "EquivocalWeakAgainst",
            "Rating": "VeryLow",
            "ErrorMessage": "Sample ErrorMessage text."
          }
        ],
        "Message": "Sample Message text."
      },
      "Condition": {
        "LevelsOfEvidence": [
          {
            "Recommended": true,
            "StrengthOfRecommendation": "EquivocalWeakAgainst",
            "Rating": "VeryLow",
            "ErrorMessage": "Sample ErrorMessage text."
          },
          {
            "Recommended": true,
            "StrengthOfRecommendation": "EquivocalWeakAgainst",
            "Rating": "VeryLow",
            "ErrorMessage": "Sample ErrorMessage text."
          }
        ],
        "RequestSource": "Diganosed",
        "ConditionId": {
          "IdType": "ICD10",
          "Id": "123ABC5"
        },
        "Description": "Sample Description text.",
        "InfoMessage": "Sample InfoMessage text."
      },
      "MonographSectionId": 6,
      "AgeBands": [
        {
          "Name": "Sample Name text.",
          "Gender": "Female"
        },
        {
          "Name": "Sample Name text.",
          "Gender": "Female"
        }
      ],
      "Message": "Sample Message text."
    }
  ],
  "DrugsNotMatched": [
    {
      "DrugId": {
        "IdType": "NDC11",
        "Id": "12345-6789-07"
      },
      "Name": "Sample Name text.",
      "LevelsOfEvidence": [
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        },
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        }
      ],
      "Message": "Sample Message text."
    },
    {
      "DrugId": {
        "IdType": "NDC11",
        "Id": "12345-6789-08"
      },
      "Name": "Sample Name text.",
      "LevelsOfEvidence": [
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        },
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        }
      ],
      "Message": "Sample Message text."
    }
  ],
  "DrugsNotFound": [
    {
      "DrugId": {
        "IdType": "NDC11",
        "Id": "12345-6789-00"
      },
      "Name": "Sample Name text.",
      "LevelsOfEvidence": [
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        },
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        }
      ],
      "Message": "Sample Message text."
    },
    {
      "DrugId": {
        "IdType": "NDC11",
        "Id": "12345-6789-01"
      },
      "Name": "Sample Name text.",
      "LevelsOfEvidence": [
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        },
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        }
      ],
      "Message": "Sample Message text."
    }
  ],
  "DiagnosesNotMatched": [
    {
      "ConditionId": {
        "IdType": "ICD10",
        "Id": "123ABC11"
      },
      "Description": "Sample Description text.",
      "InfoMessage": "Sample InfoMessage text.",
      "LevelsOfEvidence": [
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        },
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        }
      ]
    },
    {
      "ConditionId": {
        "IdType": "ICD10",
        "Id": "123ABC12"
      },
      "Description": "Sample Description text.",
      "InfoMessage": "Sample InfoMessage text.",
      "LevelsOfEvidence": [
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        },
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        }
      ]
    }
  ],
  "DiagnosesWithNoDrugThearapy": [
    {
      "ConditionId": {
        "IdType": "ICD10",
        "Id": "123ABC13"
      },
      "Description": "Sample Description text.",
      "InfoMessage": "Sample InfoMessage text.",
      "LevelsOfEvidence": [
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        },
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        }
      ]
    },
    {
      "ConditionId": {
        "IdType": "ICD10",
        "Id": "123ABC14"
      },
      "Description": "Sample Description text.",
      "InfoMessage": "Sample InfoMessage text.",
      "LevelsOfEvidence": [
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        },
        {
          "Recommended": true,
          "StrengthOfRecommendation": "EquivocalWeakAgainst",
          "Rating": "VeryLow",
          "ErrorMessage": "Sample ErrorMessage text."
        }
      ]
    }
  ]
}