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
DrugDiseaseMatchDrugToDiagnosisRequestName | Description | Type | Additional 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. |
UseCategorizedTerms | When using results from ListGSTermsByCategory as input to this method, set this to 'true' to use categorized terms. Default is 'false'. | boolean |
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": "2025-01-17", "Gender": "Female", "UseCategorizedTerms": true, "AccessToken": "T25lX0hhcHB5X0FuZF9TYXRpc2ZpZWRfR1NERF9DdXN0b21lcl9TYW1wbGVfQWNjZXNzVG9rZW4=" }
Response Information
Resource Description
DrugDiseaseMatchDrugToDiagnosisResponseName | Description | Type | Additional 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." } ] } ] }