Overview Authentication POST /check POST /ask POST /graph-evalSoon POST /graph-searchSoon POST /graph-neighborhoodSoon Severity Levels Drug Resolution Rate Limits Error Codes

POST /v1/interactions/check

Check drug interactions for a list of drug names. Returns severity-scored interaction pairs with mechanisms, recommendations, and evidence citations from FDA labeling.

Request

POST /v1/interactions/check
Content-Type: application/json
x-api-key: rxlg_your_api_key

Parameters

Name	Type	Required	Description
drugs	string[]	required	Array of drug names (1-10). Accepts generic names, brand names, NDC codes, or RxCUI identifiers.
format	string	optional	"structured" (default), "summary", or "conversational".

Examples

cURL

curl -X POST "https://api.rxlabelguard.com/v1/interactions/check" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"drugs": ["warfarin", "aspirin"]}'

JavaScript

const response = await fetch("https://api.rxlabelguard.com/v1/interactions/check", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    drugs: ["warfarin", "aspirin"],
    format: "summary",
  }),
});

const data = await response.json();
console.log(data.pairs);    // Interaction pairs with severity
console.log(data.summary);  // AI-generated summary

Python

import requests

response = requests.post(
    "https://api.rxlabelguard.com/v1/interactions/check",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"drugs": ["warfarin", "aspirin"]},
)

data = response.json()
for pair in data["pairs"]:
    print(f"{pair['drugA']} + {pair['drugB']}: {pair['maxSeverity']}")

Response Schema

{
  "resolutions": [
    {
      "inputName": "warfarin",
      "rxcui": "11289",
      "genericName": "warfarin",
      "brandNames": ["COUMADIN"],
      "splSetId": "abc-123",
      "labelUrl": "https://dailymed.nlm.nih.gov/dailymed/drugInfo.cfm?setid=abc-123",
      "resolved": true
    }
  ],
  "pairs": [
    {
      "drugA": "warfarin",
      "drugB": "aspirin",
      "maxSeverity": "major",
      "interactions": [
        {
          "source": "warfarin",
          "targetName": "aspirin",
          "severity": "major",
          "mechanism": "Increased anticoagulant effect and bleeding risk",
          "recommendation": "Monitor INR closely if coadministered",
          "evidenceSnippet": "Aspirin increases bleeding risk.",
          "labelSection": "drug_interactions",
          "splSetId": "abc-123"
        }
      ]
    }
  ],
  "disclaimer": "This information is derived from FDA...",
  "errors": [],
  "summary": null
}

The summary field is populated when format is "summary" or "conversational".